...
Eroare JavaScript · Colecții, iteratori și generatori (Map, Set, WeakMap)

RangeError: Invalid index : 3

Pe scurt

Array.prototype.with(index, valoare) poate doar înlocui un element existent, iar indexul dat e în afara tabloului (de exemplu egal cu length sau mai negativ decât -length). with nu adaugă elemente. Pentru adăugare folosește [...lista, valoare] sau toSpliced.

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

Ce înseamnă

lista.with(index, valoare) întoarce o copie a tabloului în care elementul de la index e înlocuit, fără să modifice originalul. Indexul trebuie să existe: între 0 și length - 1, sau între -length și -1 pentru numărarea de la final. Orice altceva dă Invalid index : <index>, cu indexul primit afișat în mesaj.

Diferența față de atribuirea clasică surprinde: lista[3] = x pe un tablou cu trei elemente adaugă un element nou (sau lasă goluri), dar lista.with(3, x) aruncă eroare. Cauzele tipice sunt folosirea lui with pentru adăugare la final (with(lista.length, x)), un index găsit cu findIndex care a întors -1 dintr-un tablou gol, sau o eroare de numărare (pornești de la 1 în loc de 0).

Verifică indexul înainte și alege metoda potrivită: with pentru înlocuire, spread sau toSpliced(index, 0, x) pentru inserare.

De ce apare: cauzele frecvente

1with folosit pentru adăugare

Greșit
JavaScript
const nou = lista.with(lista.length, "kiwi");
Corect
JavaScript
const nou = [...lista, "kiwi"];

with doar înlocuiește. Pentru un element nou la final, spread-ul creează copia cu elementul adăugat.

2Index de la findIndex care nu a găsit nimic

Greșit
JavaScript
const i = cos.findIndex((p) => p.id === 9);
const nou = cos.with(i, actualizat);
Corect
JavaScript
const i = cos.findIndex((p) => p.id === 9);
const nou = i === -1 ? [...cos, actualizat] : cos.with(i, actualizat);

-1 e valid doar dacă tabloul are elemente (înseamnă ultimul). Verifici rezultatul căutării înainte.

3Numărare de la 1

Greșit
JavaScript
const pozitie = 3; // a treia
const nou = ["a", "b", "c"].with(pozitie, "C");
Corect
JavaScript
const pozitie = 3;
const nou = ["a", "b", "c"].with(pozitie - 1, "C");

Indexurile pornesc de la 0, deci a treia poziție are indexul 2.

Repară tu

Repară eroarea, direct în pagină

Funcția adaugaSauInlocuieste actualizează un produs din listă fără să modifice tabloul original. Pentru un produs nou, findIndex întoarce -1, iar codul folosește with(lista.length, ...), care aruncă RangeError: Invalid index : 2. Repară funcția ca produsele noi să fie adăugate la final.

Codul care dă eroarea
JavaScript
function adaugaSauInlocuieste(lista, produs) {
  const i = lista.findIndex((p) => p.id === produs.id);
  const pozitie = i === -1 ? lista.length : i;
  return lista.with(pozitie, produs);
}

let cos = [{ id: 1, nume: "Lapte" }, { id: 2, nume: "Pâine" }];
cos = adaugaSauInlocuieste(cos, { id: 2, nume: "Pâine integrală" });
cos = adaugaSauInlocuieste(cos, { id: 3, nume: "Ouă" });
console.log(cos.map((p) => p.nume).join(", "));
După reparație, programul afișează
Lapte, Pâine integrală, Ouă
Indiciu

with poate doar înlocui; pentru un produs negăsit creează copia cu spread.

Alte forme ale mesajului

  • RangeError: Invalid index : -5
  • RangeError: Invalid index : 10

Cum o eviți pe viitor

  • Folosește with doar pentru înlocuirea unor elemente existente.
  • Pentru adăugare, folosește [...lista, x], toSpliced(i, 0, x) sau concat.
  • Verifică rezultatul lui findIndex (!== -1) înainte să-l folosești ca index.
  • Când primești poziții de la utilizator (numărate de la 1), scade 1 într-un singur loc.

Întrebări frecvente

De ce lista[3] = x merge, iar lista.with(3, x) nu?

Atribuirea directă poate extinde tabloul. with e gândită ca operație sigură, fără efecte neașteptate, așa că refuză indexurile inexistente în loc să creeze goluri.

Merge with cu indexuri negative?

Da, -1 înseamnă ultimul element, -2 penultimul. Eroarea apare doar când indexul negativ depășește lungimea tabloului.

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.