Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Operator instanceof

Gdy po prawej stronie jest zwykła, niewiązana funkcja, operator instanceof domyślnie sprawdza, czy jej `prototype` występuje w łańcuchu prototypów obiektu. Uwzględnia dziedziczenie, ale nie potwierdza sposobu utworzenia obiektu ani obecności jego pól.

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

value instanceof Target

value instanceof Target zwraca wartość logiczną albo zgłasza wyjątek. W domyślnym teście, gdy value jest obiektem, a Target zwykłą, niewiązaną funkcją, operator szuka obiektu Target.prototype w łańcuchu prototypów value, porównując tożsamość obiektów. Dlatego instancja klasy pochodnej jest też instancją klasy bazowej. Jeśli Target jest funkcją związaną (na przykład utworzoną za pomocą bind), wbudowany mechanizm ponawia test instanceof z funkcją, którą Target opakowuje, zamiast odczytywać Target.prototype. Nie wymaga to własnej metody Symbol.hasInstance. instanceof jest słowem zastrzeżonym.

Test nie sprawdza właściwości constructor ani historii wywołania new. Obiekt utworzony przez Object.create(Target.prototype) może przejść test bez wykonania konstruktora. Zmiana prototypów może zmienić wynik; odrębne środowiska wykonania, takie jak ramki, mogą mieć różne obiekty prototypów.

Target[Symbol.hasInstance] może dostosować test; wynik tej metody jest konwertowany na wartość logiczną. Bez własnej obsługi prymitywy po lewej stronie dają false. Prymityw po prawej stronie powoduje TypeError; bez odpowiedniej metody prawa strona musi być wywoływalna. Jeśli domyślny test obiektu odczytuje Target.prototype, a ta wartość nie jest obiektem, zgłasza TypeError.

Negację zapisuj jako !(value instanceof Target), nie !value instanceof Target: drugi zapis testuje !value. Nie traktuj wyniku jako dowodu obecności pól lub poprawności danych.

Przykłady

class Animal {}
class Dog extends Animal {}

const dog = new Dog();
const linked = Object.create(Dog.prototype);

console.log(dog instanceof Dog);
console.log(dog instanceof Animal);
console.log(linked instanceof Dog);
console.log("dog" instanceof String);

Wynik

true
true
true
false

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

Źródła