[ Leksykon ] [ JavaScript ] [ Tablice ] [ Metody ] [ Właściwości ] [ Array() ]

Array.prototype.splice()

[_] [A] [B] [C] [D] [E] [F] [G] [H] [I] [J] [K] [L] [M] [N] [O] [P] [Q] [R] [S] [T] [U] [V] [W] [X] [Y] [Z]

 

Przykłady:

const tablica = ['A','C', 'D', 'F', , ];
tablica.splice(1, 0, 'B');
console.log(tablica);
// Array ["A", "B", "C", "D", "F", undefined]

tablica.splice(4, 1, 'E');
console.log(tablica);
// Array ["A", "B", "C", "D", "E", undefined]

  

const tablica = ['A','C', 'D', 'F', , ];
console.log(tablica.splice(1, 0, "B"));
console.log(tablica);
// Array []
// Array ["A", "B", "C", "D", "F", undefined]

 

const tablica = ['A','D', 'E', 'F', , ];
console.log(tablica.splice(1, 0, "B", "C"));
console.log(tablica);
// Array []
// Array ["A", "B", "C", "D", "E", "F", undefined]

 

const tablica = ['A','D', 'E', 'F', , ];
console.log(tablica.splice(1, 1, "B"));
console.log(tablica);
// Array ["D"]
// Array ["A", "B", "E", "F", undefined]

 

const tablica = ['A','D', 'E', 'F', , ];
console.log(tablica.splice(1, 1));
console.log(tablica);
// Array ["D"]
// Array ["A", "E", "F", undefined]

 

const tablica = ['A','D', 'E', 'F', , ];
console.log(tablica.splice(-1, 1));
console.log(tablica);
// Array [undefined]
// Array ["A", "D", "E", "F"]

 

const tablica = ['A','D', 'E', 'F', , ];
console.log(tablica.splice(2));
console.log(tablica);
// Array ["E", "F", undefined]
// Array ["A", "D"]

 

const tablica = {
 length: 3,
 informacja: "brak",
 0: 'A',
 2: 'D',
};
console.log(Array.prototype.splice.call(tablica, 0, 1, 'B', 'C'));
// Array ["A"]
console.log(tablica);
// Object { 0: "B", 1: "C", 3: "D", length: 4, informacja: "brak" }

 

Opis:
Metoda Array.splice() zmienia zawartość tablicy, usuwając lub zastępując istniejące elementy i/lub dodając nowe elementy. Aby utworzyć nową tablicę z usuniętym i/lub zastąpionym segmentem bez mutacji oryginalnej tablicy, użyj toSpliced(). Aby uzyskać dostęp do części tablicy bez jej modyfikowania, zobacz slice(). Pierwszym parametrem liczba całkowita liczona od zera od którego należy rozpocząć zmianę tablicy. Ujemny indeks liczy wstecz od końca tablicy — jeśli użyto start < 0, .start + array.length. Jeśli start < -array.length, 0 jest używany. Jeśli start >= array.length, żaden element nie zostanie usunięty, ale metoda będzie zachowywać się jak funkcja dodająca, dodając tyle elementów, ile podano. Jeśli pierwszy parametr zostanie pominięty i splice() zostanie wywołany bez argumentów, nic nie zostanie usunięte. Różni się to od przekazywania undefined, które jest konwertowane na 0. Drugi argument liczba całkowita wskazująca liczbę elementów w tablicy do usunięcia z pierwszego argumentu. Jeśli drugi argument zostanie pominięty lub jeśli jego wartość jest większa lub równa liczbie elementów po pozycji określonej przez pierwszy argument, to wszystkie elementy od pierwszego argument końca tablicy zostaną usunięte. Jeśli jednak chcesz przekazać dowolny kolejny parametr, powinieneś przekazać nieskończoność jako, drugi parametr usunąć wszystkie elementy po liczbie z pierwszego parametru, ponieważ undefined jest konwertowany na 0. Jeśli drugi paramtr jest 0 lub ujemne, żadne elementy nie są usuwane. W takim przypadku należy określić co najmniej jeden nowy element. Kolejne parametry to elementy, które mają zostać dodane do tablicy, poczawszy od pierwszego parametru. Jeśli nie określisz żadnych elementów, splice() usunie tylko elementy z tablicy. Zwracana wartość tablica zawierająca usunięte elementy. Jeśli usunie się tylko jeden element, zwracana jest tablica zawierająca jeden element. Jeśli żadne elementy nie zostaną usunięte, zwracana jest pusta tablica. Metoda splice() jest metodą mutującą. Może zmienić treść this. Jeśli określona liczba elementów do wstawienia różni się od liczby elementów usuwanych, tablica length również zostanie zmieniona. W tym samym czasie tworzy @@species nową instancję tablicy, która ma zostać zwrócona. Metoda splice() jest ogólna. Oczekuje tylko, że this wartość będzie miała length właściwość i właściwości z kluczem całkowitym.

Zobacz też:
slice() - 
toSpliced() -