...
Eroare JavaScript · Erori de sintaxă (SyntaxError)

SyntaxError: Invalid tagged template on optional chain

Pe scurt

Ai pus un template literal direct după un lanț opțional, de exemplu formatare?.lei urmat de backticks. Un tag de template nu poate fi apelat printr-un lanț opțional. Verifică întâi că funcția există și apoi folosește-o ca tag, sau apeleaz-o normal: obj?.format?.(...).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un tagged template este un apel de funcție scris cu backticks: ` tagSalut ${nume} apelează tag cu bucățile de text și valorile. Cu lanțul opțional (?.), o expresie se poate opri la undefined dacă ceva lipsește. Combinația obj?.tag... ` e ambiguă (ar trebui să sară apelul sau nu?), așa că standardul o interzice, iar motorul o refuză la parsare.

Apare la bibliotecile care folosesc template-uri cu tag (` styled.div... , sql... , html... ) când cineva vrea să se protejeze de lipsa obiectului cu ?.`.

Ai două variante: verifici explicit că tag-ul există (if (obj.tag)) și apoi îl folosești normal, sau renunți la sintaxa cu tag și apelezi funcția cu ?.(), dându-i argumentele manual.

De ce apare: cauzele frecvente

1Tag apelat printr-un lanț opțional

Greșit
JavaScript
const text = formatare?.lei`Total: ${suma}`;
Corect
JavaScript
const text = formatare ? formatare.lei`Total: ${suma}` : `Total: ${suma}`;

Verificarea se face separat, iar tag-ul se aplică doar când obiectul există.

2Funcție opțională folosită ca tag

Greșit
JavaScript
log?.`Pornire`;
Corect
JavaScript
if (log) log`Pornire`;

Lanțul opțional nu poate fi urmat de un template; un if face aceeași protecție.

Repară tu

Repară eroarea, direct în pagină

Codul formatează un total cu tag-ul lei din obiectul formatare, protejat cu ?., dar dă SyntaxError: Invalid tagged template on optional chain. Repară expresia (păstrând tag-ul atunci când obiectul există) ca programul să afișeze Total: 120 lei.

Codul care dă eroarea
JavaScript
const formatare = {
  lei: (bucati, ...valori) => bucati.reduce((t, b, i) => t + b + (i < valori.length ? `${valori[i]} lei` : ""), ""),
};
const suma = 120;

const text = formatare?.lei`Total: ${suma}`;
console.log(text);
După reparație, programul afișează
Total: 120 lei
Indiciu

Verifică obiectul formatare cu un operator ternar și folosește tag-ul fără ?.

Alte forme ale mesajului

  • SyntaxError: tagged template cannot be used in optional chain
  • Uncaught SyntaxError: Invalid tagged template on optional chain

Cum o eviți pe viitor

  • Verifică existența obiectelor cu tag la începutul funcției, nu în expresia cu template.
  • Pentru funcții opționale, folosește fn?.(argumente), nu un template cu tag.
  • Dacă un tag poate lipsi, dă-i o variantă implicită: const tag = formatare?.lei ?? String.raw.

Întrebări frecvente

De ce obj?.metoda() merge, dar obj?.metodatext nu?

Pentru apelurile cu paranteze există sintaxa ?.(), definită în standard. Pentru template-uri cu tag nu s-a definit o variantă opțională, iar combinația a fost interzisă explicit.

Ce face String.raw ca tag implicit?

String.raw lipește textul și valorile fără să proceseze nimic, deci e un tag neutru bun ca rezervă.

Erori înrudite

← Toate erorile JavaScript

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ță JavaScript de la zero, cu exerciții la fiecare lecție

Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.