Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Set.prototype.delete — usuwanie wartości ze zbioru

Metoda Set.prototype.delete(value) usuwa wskazaną wartość z istniejącego zbioru. Zwraca true, jeśli usunięcie nastąpiło, albo false, jeśli wartości nie było. Obiekty są dopasowywane według tożsamości, a nie zawartości.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

set.delete(value)

set.delete(value) zmienia istniejący Set: usuwa pasującą wartość i zwraca true. Jeśli wartości nie ma, zwraca false bez zmiany zbioru. Argument oznacza wartość, nie indeks. Wynikiem jest wartość logiczna, a nie zbiór, więc nie można łączyć kolejnych wywołań .delete() w łańcuch.

Dopasowanie odpowiada regule SameValueZero: NaN pasuje do NaN, a +0 i -0 są traktowane jako ta sama wartość. Obiekty są porównywane według tożsamości. Nowy obiekt { id: 1 } nie pasuje do wcześniej dodanego obiektu o takich samych polach; trzeba przekazać referencję do tego samego obiektu.

Nie myl tej metody z operatorem delete, który usuwa właściwości obiektów, ani z set.clear(), które usuwa wszystkie elementy. Metoda wymaga odbiorcy z wewnętrznymi danymi Set; wywołanie Set.prototype.delete.call({}, value) zgłasza TypeError. To API języka ECMAScript, nie API przeglądarki; sama obecność Node.js w projekcie nie potwierdza obsługi w docelowych przeglądarkach.

Przykłady

const item = { id: 1 };
const values = new Set(["ready", item, NaN]);

console.log(values.delete("ready"));
console.log(values.delete("ready"));
console.log(values.delete({ id: 1 }));
console.log(values.delete(item));
console.log(values.delete(NaN));
console.log(values.size);

Wynik

true
false
false
true
true
0

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła