NodeVisitor.java

/* -*- Mode: java; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 4 -*-
 *
 * 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/. */

package org.mozilla.javascript.ast;

/**
 * Simple visitor interface for traversing the AST.  The nodes are visited in
 * an arbitrary order.  The visitor must cast nodes to the appropriate
 * type based on their token-type.
 */
public interface NodeVisitor {

    /**
     * Visits an AST node.
     * @param node the AST node.  Will never visit an {@link AstRoot} node,
     * since the {@code AstRoot} is where the visiting begins.
     * @return {@code true} if the children should be visited.
     * If {@code false}, the subtree rooted at this node is skipped.
     * The {@code node} argument should <em>never</em> be {@code null} --
     * the individual {@link AstNode} classes should skip any children
     * that are not present in the source when they invoke this method.
     */
    boolean visit(AstNode node);
}