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

js
contains(otherNode)

Parameter

otherNode

Der zu testende Node.

Hinweis:>otherNode ist nicht optional, kann jedoch auf null gesetzt werden.

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.

js
function isInPage(node) {
  return node === document.body ? false : document.body.contains(node);
}

Spezifikationen

Specification
DOM
# ref-for-dom-node-contains①

Browser-Kompatibilität

Siehe auch