NodeIterator: filter-Eigenschaft

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 schreibgeschützte Eigenschaft NodeIterator.filter gibt ein NodeFilter-Objekt zurück, das ein Objekt ist, welches eine acceptNode(node)-Methode implementiert, um Knoten zu filtern.

Beim Erstellen des NodeIterator wird das Filterobjekt als dritter Parameter übergeben, und die Objektmethode acceptNode(node) wird für jeden einzelnen Knoten aufgerufen, um zu bestimmen, ob er akzeptiert werden soll oder nicht. Diese Funktion sollte die Konstante NodeFilter.FILTER_ACCEPT zurückgeben, wenn der Knoten akzeptiert werden soll, und NodeFilter.FILTER_REJECT, wenn der Knoten abgelehnt werden soll.

Wert

Ein NodeFilter-Objekt.

Beispiele

js
const nodeIterator = document.createNodeIterator(
  document.body,
  NodeFilter.SHOW_ELEMENT,
  {
    acceptNode(node) {
      return NodeFilter.FILTER_ACCEPT;
    },
  },
);
nodeFilter = nodeIterator.filter;

Spezifikationen

Specification
DOM Standard
# dom-nodeiterator-filter

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

  • Die Schnittstelle, zu der diese Eigenschaft gehört: NodeIterator.