...
Eroare Node.js · Asincron: callback-uri, promisiuni și timere

TypeError [ERR_INVALID_ARG_TYPE]: The "options.signal" property must be an instance of AbortSignal. Received an instance of AbortController

Pe scurt

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

Greșit
JavaScript
const controller = new AbortController();
await setTimeout(1000, null, { signal: controller });
Corect
JavaScript
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

Greșit
JavaScript
async function descarca(url, controller) {
  return fetch(url, { signal: controller });
}
Corect
JavaScript
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

Greșit
JavaScript
await once(emitter, "gata", { signal: { timeout: 5000 } });
Corect
JavaScript
await once(emitter, "gata", { signal: AbortSignal.timeout(5000) });

AbortSignal.timeout(ms) creează direct un semnal care se anulează singur după timpul dat.

Repară tu

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.

Codul care dă eroarea
JavaScript
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;
});
După reparație, programul afișează
Cafea: în stoc
Ceai: în stoc
Indiciu

Semnalul unui AbortController e în proprietatea .signal.

Alte forme ale mesajului

  • TypeError [ERR_INVALID_ARG_TYPE]: The "options.signal" property must be an instance of AbortSignal. Received an instance of Object
  • TypeError [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: controller pentru AbortController, signal pentru controller.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

← Toate erorile Node.js

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.