From 26a029d407be480d791972afb5975cf62c9360a6 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Fri, 19 Apr 2024 02:47:55 +0200 Subject: Adding upstream version 124.0.1. Signed-off-by: Daniel Baumann --- dom/base/TreeWalker.h | 79 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 dom/base/TreeWalker.h (limited to 'dom/base/TreeWalker.h') diff --git a/dom/base/TreeWalker.h b/dom/base/TreeWalker.h new file mode 100644 index 0000000000..4580a44b1f --- /dev/null +++ b/dom/base/TreeWalker.h @@ -0,0 +1,79 @@ +/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ +/* vim: set ts=4 et sw=2 tw=80: */ +/* This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ + +/* + * Implementation of DOM Traversal's TreeWalker + */ + +#ifndef mozilla_dom_TreeWalker_h +#define mozilla_dom_TreeWalker_h + +#include "nsISupports.h" +#include "nsTraversal.h" +#include "nsCOMPtr.h" +#include "nsTArray.h" +#include "nsCycleCollectionParticipant.h" + +class nsINode; + +namespace mozilla::dom { + +class TreeWalker final : public nsISupports, public nsTraversal { + virtual ~TreeWalker(); + + public: + NS_DECL_CYCLE_COLLECTING_ISUPPORTS + + TreeWalker(nsINode* aRoot, uint32_t aWhatToShow, NodeFilter* aFilter); + + NS_DECL_CYCLE_COLLECTION_CLASS(TreeWalker) + + // WebIDL API + nsINode* Root() const { return mRoot; } + uint32_t WhatToShow() const { return mWhatToShow; } + NodeFilter* GetFilter() { return mFilter; } + nsINode* CurrentNode() const { return mCurrentNode; } + void SetCurrentNode(nsINode& aNode, ErrorResult& aResult); + // All our traversal methods return strong refs because filtering can + // remove nodes from the tree. + already_AddRefed ParentNode(ErrorResult& aResult); + already_AddRefed FirstChild(ErrorResult& aResult); + already_AddRefed LastChild(ErrorResult& aResult); + already_AddRefed PreviousSibling(ErrorResult& aResult); + already_AddRefed NextSibling(ErrorResult& aResult); + already_AddRefed PreviousNode(ErrorResult& aResult); + already_AddRefed NextNode(ErrorResult& aResult); + + bool WrapObject(JSContext* aCx, JS::Handle aGivenProto, + JS::MutableHandle aReflector); + + private: + nsCOMPtr mCurrentNode; + + /* + * Implements FirstChild and LastChild which only vary in which direction + * they search. + * @param aReversed Controls whether we search forwards or backwards + * @param aResult Whether we threw or not. + * @returns The desired node. Null if no child is found + */ + already_AddRefed FirstChildInternal(bool aReversed, + ErrorResult& aResult); + + /* + * Implements NextSibling and PreviousSibling which only vary in which + * direction they search. + * @param aReversed Controls whether we search forwards or backwards + * @param aResult Whether we threw or not. + * @returns The desired node. Null if no child is found + */ + already_AddRefed NextSiblingInternal(bool aReversed, + ErrorResult& aResult); +}; + +} // namespace mozilla::dom + +#endif // mozilla_dom_TreeWalker_h -- cgit v1.2.3