TypeError [ERR_INVALID_ARG_TYPE]: The "options.signal" property must be an instance of AbortSignal. Received an instance of AbortController
Ai dat opțiunii signal obiectul AbortController în loc de semnalul lui. Scrie { signal: controller.signal }: controller-ul e telecomanda (are abort()), iar semnalul e ce primesc funcțiile care pot fi anulate.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Anularea operațiilor în Node (și în browser) folosește două obiecte: AbortController, cu metoda abort(), pe care îl păstrezi tu, și AbortSignal, din controller.signal, pe care îl dai funcțiilor care pot fi oprite: setTimeout din timers/promises, events.once, fs.promises.readFile, fetch, readline și altele.
Mesajul spune exact ce s-a întâmplat: opțiunea options.signal trebuia să fie un AbortSignal, dar a primit un AbortController. Varianta cu Received an instance of Object apare când dai un obiect oarecare, de exemplu { aborted: false }.
Atenție: eroarea e aruncată în momentul apelului, nu la anulare. Într-o funcție async devine o promisiune respinsă, deci o vezi ca eroare netratată dacă nu ai try/catch sau .catch().
De ce apare: cauzele frecvente
1Controller-ul dat în loc de semnal
const controller = new AbortController();
await setTimeout(1000, null, { signal: controller });const controller = new AbortController();
await setTimeout(1000, null, { signal: controller.signal });Funcțiile ascultă pe signal; controller rămâne la tine ca să apelezi controller.abort().
2Funcția ta primește controller-ul și îl trimite mai departe
async function descarca(url, controller) {
return fetch(url, { signal: controller });
}async function descarca(url, signal) {
return fetch(url, { signal });
}
descarca(url, controller.signal);Dă funcțiilor tale tot semnalul, nu controller-ul. Așa ele pot afla de anulare, dar nu pot anula singure.
3Timeout scris de mână în loc de AbortSignal.timeout
await once(emitter, "gata", { signal: { timeout: 5000 } });await once(emitter, "gata", { signal: AbortSignal.timeout(5000) });AbortSignal.timeout(ms) creează direct un semnal care se anulează singur după timpul dat.
Repară eroarea, direct în pagină
Programul verifică stocul mai multor produse cu o așteptare care poate fi anulată, dar dă TypeError [ERR_INVALID_ARG_TYPE]: The "options.signal" property must be an instance of AbortSignal. Received an instance of AbortController. Dă funcției asteapta semnalul corect, ca programul să afișeze stocul fiecărui produs.
const { setTimeout: asteapta } = require("timers/promises");
async function verificaStoc(produs, controller) {
await asteapta(20, null, { signal: controller });
return `${produs}: în stoc`;
}
async function main() {
const controller = new AbortController();
const rezultate = await Promise.all(["Cafea", "Ceai"].map((p) => verificaStoc(p, controller)));
rezultate.forEach((r) => console.log(r));
}
main().catch((err) => {
console.error(err.message);
process.exitCode = 1;
});Cafea: în stoc Ceai: în stoc
Indiciu
Semnalul unui AbortController e în proprietatea .signal.
Reparația
const { setTimeout: asteapta } = require("timers/promises");
async function verificaStoc(produs, signal) {
await asteapta(20, null, { signal });
return `${produs}: în stoc`;
}
async function main() {
const controller = new AbortController();
const rezultate = await Promise.all(["Cafea", "Ceai"].map((p) => verificaStoc(p, controller.signal)));
rezultate.forEach((r) => console.log(r));
}
main().catch((err) => {
console.error(err.message);
process.exitCode = 1;
});De ce merge
setTimeout din timers/promises ascultă pe un AbortSignal, obiectul care anunță anularea. AbortController e doar cel care declanșează anularea, prin abort(), iar semnalul lui e în controller.signal. Trimițând semnalul, funcția verificaStoc primește exact ce îi trebuie, iar main păstrează controller-ul, ca să poată anula toate verificările dintr-o dată dacă e nevoie.
Alte forme ale mesajului
TypeError [ERR_INVALID_ARG_TYPE]: The "options.signal" property must be an instance of AbortSignal. Received an instance of ObjectTypeError [ERR_INVALID_ARG_TYPE]: The "options.signal" property must be an instance of AbortSignal. Received type boolean (true)TypeError [ERR_INVALID_ARG_TYPE]: The "options.signal" property must be an instance of AbortSignal. Received type number (5000)
Cum o eviți pe viitor
- Numește variabilele clar:
controllerpentruAbortController,signalpentrucontroller.signal. - Funcțiile tale să primească un
signal, nu un controller. - Pentru timeout simplu, folosește
AbortSignal.timeout(ms); pentru mai multe semnale,AbortSignal.any([s1, s2]). - Când o funcție acceptă anulare, documentează în comentariu că primește un
AbortSignal, ca apelanții să știe ce să trimită.
Întrebări frecvente
De ce sunt două obiecte și nu unul?
Ca să separi cine poate anula de cine doar află de anulare. Codul care pornește operația ține controller-ul; funcțiile apelate primesc doar semnalul și nu pot anula din greșeală altceva.
Ce primesc când operația e chiar anulată?
O eroare AbortError: The operation was aborted, sau TimeoutError dacă semnalul vine de la AbortSignal.timeout. Pe acestea le tratezi cu try/catch.
Erori înrudite
Error [ERR_USE_AFTER_CLOSE]: readline was closed Ai apelat rl.question() (sau alt apel readline) după ce interfața s-a închis: fie ai apelat rl.close() prea devreme, fie intrarea s-a terminat (Ctrl+D sau date trimise prin pipe), iar readline s-a închis singur. Pune rl.close() după ultima întrebare și nu mai întreba nimic în handler-ul close. UnhandledPromiseRejection: This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). The promise rejected with the reason "Stoc insuficient". O promisiune a fost respinsă și nimeni nu a tratat eroarea: lipsește try/catch în jurul lui await sau .catch() la final. Din Node 15, o respingere netratată oprește programul. Adaugă try/catch (sau .catch) și respinge cu new Error(...), nu cu un text. TypeError [ERR_INVALID_ARG_TYPE]: The "callback" argument must be of type function. Received undefined Ai dat lui setTimeout, setInterval sau setImmediate rezultatul unei funcții în loc de funcția însăși, de obicei scriind setTimeout(trimite(), 1000). Pune funcția fără paranteze, setTimeout(trimite, 1000), sau într-o funcție săgeată: setTimeout(() => trimite("Ana"), 1000). Învață Node.js de la zero, cu exerciții la fiecare lecție
Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
