DXR is a code search and navigation tool aimed at making sense of large projects. It supports full-text and regex searches as well as structural queries.

Implementation

Mercurial (85b4e005b39c)

VCS Links

Line Code
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99
/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim: set ts=8 sts=2 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/. */

#ifndef mozilla_dom_WebIDLGlobalNameHash_h__
#define mozilla_dom_WebIDLGlobalNameHash_h__

#include "js/RootingAPI.h"
#include "nsTArray.h"
#include "mozilla/dom/BindingDeclarations.h"

class JSFlatString;

namespace mozilla {
namespace dom {

namespace constructors {
namespace id {
enum ID : uint16_t;
}  // namespace id
}  // namespace constructors

struct WebIDLNameTableEntry {
  // Check whether a constructor should be enabled for the given object.
  // Note that the object should NOT be an Xray, since Xrays will end up
  // defining constructors on the underlying object.
  typedef bool (*ConstructorEnabled)(JSContext* cx, JS::Handle<JSObject*> obj);

  uint16_t mNameOffset;
  uint16_t mNameLength;
  constructors::id::ID mConstructorId;
  CreateInterfaceObjectsMethod mCreate;
  // May be null if enabled unconditionally
  ConstructorEnabled mEnabled;
};

class WebIDLGlobalNameHash {
 public:
  typedef WebIDLNameTableEntry::ConstructorEnabled ConstructorEnabled;

  // Returns false if something failed. aFound is set to true if the name is in
  // the hash, whether it's enabled or not.
  static bool DefineIfEnabled(JSContext* aCx, JS::Handle<JSObject*> aObj,
                              JS::Handle<jsid> aId,
                              JS::MutableHandle<JS::PropertyDescriptor> aDesc,
                              bool* aFound);

  static bool MayResolve(jsid aId);

  // The type of names we're asking for.
  enum NameType {
    // All WebIDL names enabled for aObj.
    AllNames,
    // Only the names that are enabled for aObj and have not been resolved for
    // aObj in the past (and therefore can't have been deleted).
    UnresolvedNamesOnly
  };
  // Returns false if an exception has been thrown on aCx.
  static bool GetNames(JSContext* aCx, JS::Handle<JSObject*> aObj,
                       NameType aNameType,
                       JS::MutableHandleVector<jsid> aNames);

  // Helpers for resolving & enumerating names on the system global.
  // NOTE: These are distinct as it currently lacks a ProtoAndIfaceCache, and is
  // an XPCOM global.
  static bool ResolveForSystemGlobal(JSContext* aCx, JS::Handle<JSObject*> aObj,
                                     JS::Handle<jsid> aId, bool* aResolvedp);

  static bool NewEnumerateSystemGlobal(
      JSContext* aCx, JS::Handle<JSObject*> aObj,
      JS::MutableHandleVector<jsid> aProperties, bool aEnumerableOnly);

 private:
  friend struct WebIDLNameTableEntry;

  // Look up an entry by key name. `nullptr` if the entry was not found.
  // The impl of GetEntry is generated by Codegen.py in RegisterBindings.cpp
  static const WebIDLNameTableEntry* GetEntry(JSFlatString* aKey);

  // The total number of names in the hash.
  // The value of sCount is generated by Codegen.py in RegisterBindings.cpp.
  static const uint32_t sCount;

  // The name table entries in the hash.
  // The value of sEntries is generated by Codegen.py in RegisterBindings.cpp.
  static const WebIDLNameTableEntry sEntries[];

  // The names registered in the hash, concatenated as one big string with \0
  // as a separator between names.
  // The value of sNames is generated by Codegen.py in RegisterBindings.cpp.
  static const char sNames[];
};

}  // namespace dom
}  // namespace mozilla

#endif  // mozilla_dom_WebIDLGlobalNameHash_h__