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

Array.prototype.flat()

[_] [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]

flat()
flat(depth)

Przykłady:

const tablicaA = [0, 1, 2, [3, 4], 5, 6, 7, 8, 9];
console.log(tablicaA.flat());
// Array [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]

const tablicaB = [0, 1, [2, [3, [4, 5, 6, 7, 8 , 9]]]];
console.log(tablicaB.flat());
// Array [0, 1, 2, Array [3, Array [4, 5, 6, 7, 8, 9]]]
console.log(tablicaB.flat(2));
// Array [0, 1, 2, 3, Array [4, 5, 6, 7, 8, 9]]
console.log(tablicaB.flat(Infinity));
// Array [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]

const tablicaC = [0, 1, 2, [3, 4], 5,, 7,, 9];
console.log(tablicaC.flat());
// Array [0, 1, 2, 3, 4, 5, 7, 9]

const tablica = {
 length: 5,
 0: [1, 2, 3],
 1: { length: 2, 0: 3, 1: 4 },
 2: 5,
 3: 3,
 4: 10,
};
console.log(Array.prototype.flat.call(tablica));
// Array [1, 2, 3, Object { 0: 3, 1: 4, length: 2 }, 5, 3, 10]

Opis:
Metoda Array.flat() instancji Array tworzy nową tablicę ze wszystkimi elementami pod tablicy połączonymi w nią rekurencyjnie do określonej głębokości. Parametr pierwszy opcjonalny poziom określający głębokość spłaszczenia zagnieżdżonej struktury tablicowej. Domyślnie 1. Wartość zwracana nowa tablica z połączonymi w niej elementami pod tablicy. Metoda flat() jest metodą kopiowania. Nie zmienia this, ale zamiast tego zwraca płytką kopię zawierającą te same elementy, co te z oryginalnej tablicy. Metoda flat() ignoruje puste miejsca, jeśli spłaszczana tablica jest rzadka . Na przykład, jeśli pierwszy parametr wynosi 1, zarówno puste miejsca w tablicy głównej, jak i na pierwszym poziomie tablic zagnieżdżonych są ignorowane, ale puste miejsca w kolejnych zagnieżdżonych tablicach są zachowywane wraz z samymi tablicami. Metoda flat() 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. Jednakże jego elementy muszą być tablicami, jeśli mają zostać spłaszczone.

Linki: