import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
CollectDefines(AbstractCompiler compiler, List<Name> listOfDefines) {
  this.compiler = compiler;
  this.allDefines = Maps.newHashMap();

  assignableDefines = Maps.newHashMap();
  assignAllowed = new ArrayDeque<Integer>();
  assignAllowed.push(1);

  // Create a map of references to defines keyed by node for easy lookup
  allRefInfo = Maps.newHashMap();
  for (Name name : listOfDefines) {
    if (name.declaration != null) {
      allRefInfo.put(name.declaration.node,
                     new RefInfo(name.declaration, name));
    }
    if (name.refs != null) {
      for (Ref ref : name.refs) {
        // If there's a TWIN def, only put one of the twins in.
        if (ref.getTwin() == null || !ref.getTwin().isSet()) {
          allRefInfo.put(ref.node, new RefInfo(ref, name));
        }
      }
    }
  }
}
 

import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
/**
 * Runs through all namespaces (prefixes of classes and enums), and checks if
 * any of them have been used in an unsafe way.
 */
private void checkNamespaces() {
  for (Name name : nameMap.values()) {
    if (name.isNamespace() && name.refs != null &&
        (name.aliasingGets > 0 || name.localSets + name.globalSets > 1)) {
      boolean initialized = name.declaration != null;
      for (Ref ref : name.refs) {
        if (ref.type == Ref.Type.SET_FROM_GLOBAL ||
            ref.type == Ref.Type.SET_FROM_LOCAL) {
          if (initialized) {
            warnAboutNamespaceRedefinition(name, ref);
          }

          initialized = true;
        } else if (ref.type == Ref.Type.ALIASING_GET) {
          warnAboutNamespaceAliasing(name, ref);
        }
      }
    }
  }
}
 

import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
/**
 * Collapses definitions of the collapsible properties of a global name.
 * Recurses on subnames that also represent JavaScript objects with
 * collapsible properties.
 *
 * @param n A node representing a global name
 * @param alias The flattened name for {@code n}
 */
private void collapseDeclarationOfNameAndDescendants(Name n, String alias) {
  boolean canCollapseChildNames = n.canCollapseUnannotatedChildNames();

  // Handle this name first so that nested object literals get unrolled.
  if (n.canCollapse() && canCollapseChildNames) {
    updateObjLitOrFunctionDeclaration(n, alias);
  }

  if (n.props != null) {
    for (Name p : n.props) {
      // Recurse first so that saved node ancestries are intact when needed.
      collapseDeclarationOfNameAndDescendants(
          p, appendPropForAlias(alias, p.name));

      if (!p.inExterns && canCollapseChildNames && p.declaration != null &&
          p.declaration.node != null &&
          p.declaration.node.getParent() != null &&
          p.declaration.node.getParent().getType() == Token.ASSIGN) {
        updateSimpleDeclaration(
            appendPropForAlias(alias, p.name), p, p.declaration);
      }
    }
  }
}
 

import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
/**
 * Warns about any references to "this" in the given FUNCTION. The function
 * is getting collapsed, so the references will change.
 */
private void checkForHosedThisReferences(Node function, JSDocInfo docInfo,
    final Name name) {
  // A function is getting collapsed. Make sure that if it refers to
  // "this", it must be a constructor or documented with @this.
  if (docInfo == null ||
      (!docInfo.isConstructor() && !docInfo.hasThisType())) {
    NodeTraversal.traverse(compiler, function.getLastChild(),
        new NodeTraversal.AbstractShallowCallback() {
          public void visit(NodeTraversal t, Node n, Node parent) {
            if (n.getType() == Token.THIS) {
              compiler.report(
                  JSError.make(name.declaration.sourceName, n,
                      UNSAFE_THIS, name.fullName()));
            }
          }
        });
  }
}
 

import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
/**
 * Checks to make sure all the descendants of a name are defined if they
 * are referenced.
 *
 * @param name A global name.
 * @param nameIsDefined If true, {@code name} is defined. Otherwise, it's
 *    undefined, and any references to descendant names should emit warnings.
 */
private void checkDescendantNames(Name name, boolean nameIsDefined) {
  if (name.props != null) {
    for (Name prop : name.props) {
      // if the ancestor of a property is not defined, then we should emit
      // warnings for all references to the property.
      boolean propIsDefined = false;
      if (nameIsDefined) {
        // if the ancestor of a property is defined, then let's check that
        // the property is also explicitly defined if it needs to be.
        propIsDefined = (!propertyMustBeInitializedByFullName(prop) ||
            prop.globalSets + prop.localSets > 0);
      }

      validateName(prop, propIsDefined);
      checkDescendantNames(prop, propIsDefined);
    }
  }
}
 

import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
private void validateName(Name name, boolean isDefined) {
  // If the name is not defined, emit warnings for each reference. While
  // we're looking through each reference, check all the module dependencies.
  Ref declaration = name.declaration;
  if (!isDefined) {
    if (declaration != null) {
      reportRefToUndefinedName(name, declaration);
    }
  }

  if (name.refs != null) {
    JSModuleGraph moduleGraph = compiler.getModuleGraph();
    for (Ref ref : name.refs) {
      if (!isDefined) {
        reportRefToUndefinedName(name, ref);
      } else {
        if (declaration != null &&
            ref.module != declaration.module &&
            !moduleGraph.dependsOn(ref.module, declaration.module)) {
          reportBadModuleReference(name, ref);
        }
      }
    }
  }
}
 

import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
public void testRemoveDeclaration1() {
  Name n = new Name("a", null, false);
  Ref set1 = createNodelessRef(Ref.Type.SET_FROM_GLOBAL);
  Ref set2 = createNodelessRef(Ref.Type.SET_FROM_GLOBAL);

  n.addRef(set1);
  n.addRef(set2);

  assertEquals(set1, n.declaration);
  assertEquals(2, n.globalSets);
  assertEquals(1, n.refs.size());

  n.removeRef(set1);

  assertEquals(set2, n.declaration);
  assertEquals(1, n.globalSets);
  assertEquals(0, n.refs.size());
}
 

import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
public void testRemoveDeclaration2() {
  Name n = new Name("a", null, false);
  Ref set1 = createNodelessRef(Ref.Type.SET_FROM_GLOBAL);
  Ref set2 = createNodelessRef(Ref.Type.SET_FROM_LOCAL);

  n.addRef(set1);
  n.addRef(set2);

  assertEquals(set1, n.declaration);
  assertEquals(1, n.globalSets);
  assertEquals(1, n.localSets);
  assertEquals(1, n.refs.size());

  n.removeRef(set1);

  assertEquals(null, n.declaration);
  assertEquals(0, n.globalSets);
}
 

import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
/**
 * Flattens all references to collapsible properties of a global name except
 * their initial definitions. Recurses on subnames.
 *
 * @param n An object representing a global name
 * @param alias The flattened name for {@code n}
 */
private void flattenReferencesToCollapsibleDescendantNames(
    Name n, String alias) {
  if (n.props == null) return;

  for (Name p : n.props) {
    String propAlias = appendPropForAlias(alias, p.getBaseName());

    if (p.canCollapse()) {
      flattenReferencesTo(p, propAlias);
    } else if (p.isSimpleStubDeclaration()) {
      flattenSimpleStubDeclaration(p, propAlias);
    }

    flattenReferencesToCollapsibleDescendantNames(p, propAlias);
  }
}
 

import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
/**
 * Warns about any references to "this" in the given FUNCTION. The function
 * is getting collapsed, so the references will change.
 */
private void checkForHosedThisReferences(Node function, JSDocInfo docInfo,
    final Name name) {
  // A function is getting collapsed. Make sure that if it refers to
  // "this", it must be a constructor or documented with @this.
  if (docInfo == null ||
      (!docInfo.isConstructor() && !docInfo.hasThisType())) {
    NodeTraversal.traverse(compiler, function.getLastChild(),
        new NodeTraversal.AbstractShallowCallback() {
          @Override
          public void visit(NodeTraversal t, Node n, Node parent) {
            if (n.isThis()) {
              compiler.report(
                  JSError.make(name.getDeclaration().getSourceName(), n,
                      UNSAFE_THIS, name.getFullName()));
            }
          }
        });
  }
}
 

import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
@Override
public void process(Node externs, Node root) {
  if (namespace == null) {
    namespace = new GlobalNamespace(compiler, externs, root);
  }

  // Find prototype properties that will affect our analysis.
  Preconditions.checkState(namespace.hasExternsRoot());
  findPrototypeProps("Object", objectPrototypeProps);
  findPrototypeProps("Function", functionPrototypeProps);
  objectPrototypeProps.addAll(
      convention.getIndirectlyDeclaredProperties());

  for (Name name : namespace.getNameForest()) {
    // Skip extern names. Externs are often not runnable as real code,
    // and will do things like:
    // var x;
    // x.method;
    // which this check forbids.
    if (name.inExterns) {
      continue;
    }

    checkDescendantNames(name, name.globalSets + name.localSets > 0);
  }
}
 

import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
public void testRemoveDeclaration1() {
  Name n = new Name("a", null, false);
  Ref set1 = createNodelessRef(Ref.Type.SET_FROM_GLOBAL);
  Ref set2 = createNodelessRef(Ref.Type.SET_FROM_GLOBAL);

  n.addRef(set1);
  n.addRef(set2);

  assertEquals(set1, n.getDeclaration());
  assertEquals(2, n.globalSets);
  assertEquals(2, n.getRefs().size());

  n.removeRef(set1);

  assertEquals(set2, n.getDeclaration());
  assertEquals(1, n.globalSets);
  assertEquals(1, n.getRefs().size());
}
 

import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
public void testRemoveDeclaration2() {
  Name n = new Name("a", null, false);
  Ref set1 = createNodelessRef(Ref.Type.SET_FROM_GLOBAL);
  Ref set2 = createNodelessRef(Ref.Type.SET_FROM_LOCAL);

  n.addRef(set1);
  n.addRef(set2);

  assertEquals(set1, n.getDeclaration());
  assertEquals(1, n.globalSets);
  assertEquals(1, n.localSets);
  assertEquals(2, n.getRefs().size());

  n.removeRef(set1);

  assertEquals(null, n.getDeclaration());
  assertEquals(0, n.globalSets);
}
 

import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
/**
 * Returns whether a ReferenceCollection for some aliasing variable references a property on the
 * original aliased variable that may be collapsed in CollapseProperties.
 *
 * <p>See {@link GlobalNamespace.Name#canCollapse} for what can/cannot be collapsed.
 */
private boolean referencesCollapsibleProperty(
    ReferenceCollection aliasRefs, Name aliasedName, GlobalNamespace namespace) {
  for (Reference ref : aliasRefs.references) {
    if (ref.getParent() == null) {
      continue;
    }
    if (ref.getParent().isGetProp()) {
      Node propertyNode = ref.getNode().getNext();
      // e.g. if the reference is "alias.b.someProp", this will be "b".
      String propertyName = propertyNode.getString();
      // e.g. if the aliased name is "originalName", this will be "originalName.b".
      String originalPropertyName = aliasedName.getName() + "." + propertyName;
      Name originalProperty = namespace.getOwnSlot(originalPropertyName);
      // If the original property isn't in the namespace or can't be collapsed, keep going.
      if (originalProperty == null || !originalProperty.canCollapse()) {
        continue;
      }
      return true;
    }
  }
  return false;
}
 

import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
/**
 * Flattens all references to collapsible properties of a global name except
 * their initial definitions. Recurs on subnames.
 *
 * @param n An object representing a global name
 * @param alias The flattened name for {@code n}
 */
private void flattenReferencesToCollapsibleDescendantNames(
    Name n, String alias) {
  if (n.props == null || n.isCollapsingExplicitlyDenied()) {
    return;
  }

  for (Name p : n.props) {
    String propAlias = appendPropForAlias(alias, p.getBaseName());

    boolean isAllowedToCollapse =
        propertyCollapseLevel != PropertyCollapseLevel.MODULE_EXPORT || p.isModuleExport();

    if (isAllowedToCollapse && p.canCollapse()) {
      flattenReferencesTo(p, propAlias);
    } else if (isAllowedToCollapse
        && p.isSimpleStubDeclaration()
        && !p.isCollapsingExplicitlyDenied()) {
      flattenSimpleStubDeclaration(p, propAlias);
    }

    flattenReferencesToCollapsibleDescendantNames(p, propAlias);
  }
}
 

import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
/**
 * Collapses definitions of the collapsible properties of a global name.
 * Recurs on subnames that also represent JavaScript objects with
 * collapsible properties.
 *
 * @param n A node representing a global name
 * @param alias The flattened name for {@code n}
 */
private void collapseDeclarationOfNameAndDescendants(Name n, String alias) {
  boolean canCollapseChildNames = n.canCollapseUnannotatedChildNames();

  // Handle this name first so that nested object literals get unrolled.
  if (canCollapse(n)) {
    updateGlobalNameDeclaration(n, alias, canCollapseChildNames);
  }

  if (n.props == null) {
    return;
  }
  for (Name p : n.props) {
    collapseDeclarationOfNameAndDescendants(p, appendPropForAlias(alias, p.getBaseName()));
  }
}
 

import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
/**
 * Warns about any references to "this" in the given FUNCTION. The function
 * is getting collapsed, so the references will change.
 */
private void checkForHosedThisReferences(Node function, JSDocInfo docInfo,
    final Name name) {
  // A function is getting collapsed. Make sure that if it refers to "this",
  // it must be a constructor, interface, record, arrow function, or documented with @this.
  boolean isAllowedToReferenceThis =
      (docInfo != null && (docInfo.isConstructorOrInterface() || docInfo.hasThisType()))
      || function.isArrowFunction();
  if (!isAllowedToReferenceThis) {
    NodeTraversal.traverseEs6(compiler, function.getLastChild(),
        new NodeTraversal.AbstractShallowCallback() {
          @Override
          public void visit(NodeTraversal t, Node n, Node parent) {
            if (n.isThis()) {
              compiler.report(
                  JSError.make(n, UNSAFE_THIS, name.getFullName()));
            }
          }
        });
  }
}
 

import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
/**
 * Adds global variable "stubs" for any properties of a global name that are only set in a local
 * scope or read but never set.
 *
 * @param n An object representing a global name (e.g. "a", "a.b.c")
 * @param alias The flattened name of the object whose properties we are adding stubs for (e.g.
 *     "a$b$c")
 * @param parent The node to which new global variables should be added as children
 * @param addAfter The child of after which new variables should be added
 */
private void addStubsForUndeclaredProperties(Name n, String alias, Node parent, Node addAfter) {
  checkState(n.canCollapseUnannotatedChildNames(), n);
  checkArgument(NodeUtil.isStatementBlock(parent), parent);
  checkNotNull(addAfter);
  if (n.props == null) {
    return;
  }
  for (Name p : n.props) {
    if (p.needsToBeStubbed()) {
      String propAlias = appendPropForAlias(alias, p.getBaseName());
      Node nameNode = IR.name(propAlias);
      Node newVar = IR.var(nameNode).useSourceInfoIfMissingFromForTree(addAfter);
      parent.addChildAfter(newVar, addAfter);
      addAfter = newVar;
      compiler.reportChangeToEnclosingScope(newVar);
      // Determine if this is a constant var by checking the first
      // reference to it. Don't check the declaration, as it might be null.
      if (p.getRefs().get(0).node.getLastChild().getBooleanProp(
          Node.IS_CONSTANT_NAME)) {
        nameNode.putBooleanProp(Node.IS_CONSTANT_NAME, true);
        compiler.reportChangeToEnclosingScope(nameNode);
      }
    }
  }
}
 

import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
@Override
public void process(Node externs, Node root) {
  if (namespace == null) {
    namespace = new GlobalNamespace(compiler, externs, root);
  }

  // Find prototype properties that will affect our analysis.
  checkState(namespace.hasExternsRoot());
  findPrototypeProps("Object", objectPrototypeProps);
  findPrototypeProps("Function", functionPrototypeProps);
  objectPrototypeProps.addAll(
      convention.getIndirectlyDeclaredProperties());

  for (Name name : namespace.getNameForest()) {
    // Skip extern names. Externs are often not runnable as real code,
    // and will do things like:
    // var x;
    // x.method;
    // which this check forbids.
    if (name.inExterns) {
      continue;
    }

    checkDescendantNames(name, name.globalSets + name.localSets > 0);
  }
}
 

import com.google.javascript.jscomp.GlobalNamespace.Name; //导入依赖的package包/类
public void testSimpleReassign2() {
  test(
      lines(
          "/** @fileoverview @suppress {newCheckTypes} */",
          "/** @define {number|boolean} */ var DEF=false;",
          "DEF=true;",
          "DEF=3"),
      lines(
          "/** @fileoverview @suppress {newCheckTypes} */",
          "/** @define {number|boolean} */ var DEF=3;",
          "true;3"));

  Name def = namespace.getNameIndex().get("DEF");
  assertThat(def.getRefs()).hasSize(1);
  assertEquals(1, def.globalSets);
  assertNotNull(def.getDeclaration());
}