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.