Node: contains() Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Die contains()
Methode der Node
Schnittstelle
gibt einen booleschen Wert zurück, der angibt,
ob ein Knoten ein Nachfahre eines bestimmten Knotens ist, also der Knoten selbst,
einer seiner direkten Kinder (childNodes
),
eines der direkten Kinder der Kinder, und so weiter.
Hinweis: Ein Knoten ist in sich selbst enthalten.
Syntax
contains(otherNode)
Parameter
Rückgabewert
Ein boolescher Wert, der true
ist, wenn otherNode
im Knoten enthalten ist,
und false
, wenn nicht.
Wenn der otherNode
Parameter null
ist,
gibt contains()
immer false
zurück.
Beispiel
Diese Funktion überprüft, ob ein Element im Body der Seite ist. Da
contains
inklusive ist und die Überprüfung, ob der Body sich selbst enthält,
nicht die Absicht von isInPage
ist, wird dieser Fall ausdrücklich false
zurückgegeben.
function isInPage(node) {
return node === document.body ? false : document.body.contains(node);
}
Spezifikationen
Specification |
---|
DOM # ref-for-dom-node-contains① |