Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Map.prototype.has: sprawdzanie klucza

Metoda has zwraca boolean wskazujący, czy Map zawiera wpis dla podanego klucza.

Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2

Składnia

map.has(key)

map.has(key) nie konwertuje klucza i nie zmienia kolekcji. Zwraca true dla istniejącego wpisu, nawet gdy jego wartością jest undefined, inaczej false.

Klucze używają SameValueZero: NaN pasuje do NaN, -0 do +0, a obiekty tylko przez identyczną referencję. Dlatego has poprawnie odróżnia brak od get zwracającego undefined.

Nieprawidłowy odbiorca powoduje TypeError. Metoda jest standardowa od ECMAScript 2015; sam wynik nie odczytuje ani nie kopiuje wartości.

Przykłady

const key = {};
const map = new Map([[key, undefined], [NaN, "nan"], [-0, "zero"]]);
console.log(map.has(key), map.has({}));
console.log(map.has(NaN), map.has(+0));
console.log(map.get(key), map.has(key));
try { Map.prototype.has.call({}, "x"); } catch (error) { console.log(error instanceof TypeError); }

Wynik

true false
true true
undefined true
true

Źródła