...
Eroare JavaScript · Șiruri, expresii regulate și URI

TypeError: First argument to String.prototype.startsWith must not be a regular expression

Pe scurt

Ai dat o expresie regulată metodei `startsWith` (sau `endsWith`, `includes`). Acestea caută doar text simplu. Fie dai un text (`url.startsWith("https")`), fie folosești regex cu `test`: `/^https?:/.test(url)`.

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

Ce înseamnă

startsWith, endsWith și includes compară textul cu un alt text, caracter cu caracter. Ca să nu crezi că ai făcut o căutare cu model când de fapt nu ai făcut, specificația interzice explicit expresiile regulate ca argument: motorul aruncă First argument to String.prototype.startsWith must not be a regular expression (respectiv endsWith, includes).

Dacă vrei un model (o literă mare la început, http sau https, cifre la final), folosește regex cu ancore: ^ pentru început, $ pentru final, și metoda test.

Dacă ai nevoie doar de text, dar cu mai multe variante, poți folosi some: ["http:", "https:"].some((p) => url.startsWith(p)).

De ce apare: cauzele frecvente

1Regex dat lui startsWith

Greșit
JavaScript
const url = "https://exemplu.ro";
if (url.startsWith(/https?:/)) {
  console.log("link");
}
Corect
JavaScript
const url = "https://exemplu.ro";
if (/^https?:/.test(url)) {
  console.log("link");
}

^ ancorează modelul la început, iar test returnează true sau false.

2Regex dat lui endsWith

Greșit
JavaScript
if (fisier.endsWith(/\.jpe?g/i)) {
  console.log("imagine");
}
Corect
JavaScript
if (/\.jpe?g$/i.test(fisier)) {
  console.log("imagine");
}

$ ancorează modelul la final. Flagul i acceptă și .JPG.

3Regex dat lui includes

Greșit
JavaScript
if (email.includes(/@/)) trimite(email);
Corect
JavaScript
if (email.includes("@")) trimite(email);

Pentru un caracter fix, textul simplu e suficient și mai clar.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos verifică dacă fiecare fișier e o imagine JPG (extensia .jpg sau .jpeg, cu litere mici sau mari), dar se oprește cu TypeError: First argument to String.prototype.endsWith must not be a regular expression. Repară verificarea ca programul să afișeze poza.jpg: da, CV.pdf: nu și vacanta.JPEG: da.

Codul care dă eroarea
JavaScript
const fisiere = ["poza.jpg", "CV.pdf", "vacanta.JPEG"];

for (const f of fisiere) {
  const eJpg = f.endsWith(/\.jpe?g/i);
  console.log(`${f}: ${eJpg ? "da" : "nu"}`);
}
După reparație, programul afișează
poza.jpg: da
CV.pdf: nu
vacanta.JPEG: da
Indiciu

Pune modelul într-o regex ancorată la final cu $ și folosește metoda test.

Alte forme ale mesajului

  • TypeError: First argument to String.prototype.endsWith must not be a regular expression
  • TypeError: First argument to String.prototype.includes must not be a regular expression
  • TypeError: startsWith: first argument must not be a regular expression

Cum o eviți pe viitor

  • Reține împărțirea: startsWith, endsWith, includes lucrează cu text; test, match, replace, search lucrează cu regex.
  • Pentru început și sfârșit cu model, folosește ^ și $ într-o regex.
  • Pentru mai multe prefixe fixe, some peste o listă de texte e mai lizibil decât un regex.

Întrebări frecvente

De ce nu transformă JavaScript regex-ul în text, ca la alte metode?

Ar da rezultate surprinzătoare: /abc/ ar deveni textul "/abc/", cu bare. Ca să nu ascundă greșeala, specificația a ales să arunce eroare.

Și indexOf cu regex?

indexOf nu aruncă, ci transformă regex-ul în text ("/abc/") și de obicei întoarce -1. Pentru căutare cu model folosește search, care întoarce poziția primei potriviri.

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.