2012-08-29 14:16:54 +08:00
|
|
|
/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 4 -*-
|
2012-05-27 22:53:48 +08:00
|
|
|
*
|
2012-10-19 11:15:23 +08:00
|
|
|
* 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/. */
|
2012-05-27 22:53:48 +08:00
|
|
|
|
|
|
|
#ifndef jspubtd_h___
|
|
|
|
#define jspubtd_h___
|
2012-08-29 14:16:54 +08:00
|
|
|
|
2012-05-27 22:53:48 +08:00
|
|
|
/*
|
|
|
|
* JS public API typedefs.
|
|
|
|
*/
|
2013-01-09 13:42:21 +08:00
|
|
|
|
|
|
|
#include "jsprototypes.h"
|
2012-05-27 22:53:48 +08:00
|
|
|
#include "jstypes.h"
|
|
|
|
|
2012-08-29 14:16:54 +08:00
|
|
|
/*
|
|
|
|
* Allow headers to reference JS::Value without #including the whole jsapi.h.
|
|
|
|
* Unfortunately, typedefs (hence jsval) cannot be declared.
|
|
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
|
|
namespace JS { class Value; }
|
|
|
|
#endif
|
2012-05-27 22:53:48 +08:00
|
|
|
|
2012-08-29 14:16:54 +08:00
|
|
|
/*
|
|
|
|
* In release builds, jsid is defined to be an integral type. This
|
|
|
|
* prevents many bugs from being caught at compile time. E.g.:
|
|
|
|
*
|
|
|
|
* jsid id = ...
|
|
|
|
* if (id == JS_TRUE) // error
|
|
|
|
* ...
|
|
|
|
*
|
|
|
|
* size_t n = id; // error
|
|
|
|
*
|
|
|
|
* To catch more errors, jsid is given a struct type in C++ debug builds.
|
|
|
|
* Struct assignment and (in C++) operator== allow correct code to be mostly
|
|
|
|
* oblivious to the change. This feature can be explicitly disabled in debug
|
|
|
|
* builds by defining JS_NO_JSVAL_JSID_STRUCT_TYPES.
|
|
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
|
|
|
|
|
|
# if defined(DEBUG) && !defined(JS_NO_JSVAL_JSID_STRUCT_TYPES)
|
|
|
|
# define JS_USE_JSID_STRUCT_TYPES
|
|
|
|
# endif
|
|
|
|
|
|
|
|
# ifdef JS_USE_JSID_STRUCT_TYPES
|
|
|
|
struct jsid
|
|
|
|
{
|
|
|
|
size_t asBits;
|
|
|
|
bool operator==(jsid rhs) const { return asBits == rhs.asBits; }
|
|
|
|
bool operator!=(jsid rhs) const { return asBits != rhs.asBits; }
|
|
|
|
};
|
|
|
|
# define JSID_BITS(id) (id.asBits)
|
|
|
|
# else /* defined(JS_USE_JSID_STRUCT_TYPES) */
|
|
|
|
typedef ptrdiff_t jsid;
|
|
|
|
# define JSID_BITS(id) (id)
|
|
|
|
# endif /* defined(JS_USE_JSID_STRUCT_TYPES) */
|
|
|
|
#else /* defined(__cplusplus) */
|
|
|
|
typedef ptrdiff_t jsid;
|
|
|
|
# define JSID_BITS(id) (id)
|
|
|
|
#endif
|
|
|
|
|
2012-05-27 22:53:48 +08:00
|
|
|
#ifdef WIN32
|
|
|
|
typedef wchar_t jschar;
|
|
|
|
#else
|
2012-08-29 14:16:54 +08:00
|
|
|
typedef uint16_t jschar;
|
2012-05-27 22:53:48 +08:00
|
|
|
#endif
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Run-time version enumeration. See jsversion.h for compile-time counterparts
|
|
|
|
* to these values that may be selected by the JS_VERSION macro, and tested by
|
|
|
|
* #if expressions.
|
|
|
|
*/
|
|
|
|
typedef enum JSVersion {
|
|
|
|
JSVERSION_ECMA_3 = 148,
|
|
|
|
JSVERSION_1_6 = 160,
|
|
|
|
JSVERSION_1_7 = 170,
|
|
|
|
JSVERSION_1_8 = 180,
|
|
|
|
JSVERSION_ECMA_5 = 185,
|
|
|
|
JSVERSION_DEFAULT = 0,
|
|
|
|
JSVERSION_UNKNOWN = -1,
|
|
|
|
JSVERSION_LATEST = JSVERSION_ECMA_5
|
|
|
|
} JSVersion;
|
|
|
|
|
|
|
|
/* Result of typeof operator enumeration. */
|
|
|
|
typedef enum JSType {
|
|
|
|
JSTYPE_VOID, /* undefined */
|
|
|
|
JSTYPE_OBJECT, /* object */
|
|
|
|
JSTYPE_FUNCTION, /* function */
|
|
|
|
JSTYPE_STRING, /* string */
|
|
|
|
JSTYPE_NUMBER, /* number */
|
|
|
|
JSTYPE_BOOLEAN, /* boolean */
|
|
|
|
JSTYPE_NULL, /* null */
|
|
|
|
JSTYPE_XML, /* xml object */
|
|
|
|
JSTYPE_LIMIT
|
|
|
|
} JSType;
|
|
|
|
|
|
|
|
/* Dense index into cached prototypes and class atoms for standard objects. */
|
|
|
|
typedef enum JSProtoKey {
|
2013-01-09 13:42:21 +08:00
|
|
|
#define PROTOKEY_AND_INITIALIZER(name,code,init) JSProto_##name = code,
|
|
|
|
JS_FOR_EACH_PROTOTYPE(PROTOKEY_AND_INITIALIZER)
|
2012-05-27 22:53:48 +08:00
|
|
|
#undef JS_PROTO
|
|
|
|
JSProto_LIMIT
|
|
|
|
} JSProtoKey;
|
|
|
|
|
|
|
|
/* js_CheckAccess mode enumeration. */
|
|
|
|
typedef enum JSAccessMode {
|
|
|
|
JSACC_PROTO = 0, /* XXXbe redundant w.r.t. id */
|
2012-10-19 11:15:23 +08:00
|
|
|
|
|
|
|
/*
|
|
|
|
* enum value #1 formerly called JSACC_PARENT,
|
|
|
|
* gap preserved for ABI compatibility.
|
|
|
|
*/
|
2012-05-27 22:53:48 +08:00
|
|
|
|
|
|
|
/*
|
|
|
|
* enum value #2 formerly called JSACC_IMPORT,
|
|
|
|
* gap preserved for ABI compatibility.
|
|
|
|
*/
|
|
|
|
|
|
|
|
JSACC_WATCH = 3, /* a watchpoint on object foo for id 'bar' */
|
|
|
|
JSACC_READ = 4, /* a "get" of foo.bar */
|
|
|
|
JSACC_WRITE = 8, /* a "set" of foo.bar = baz */
|
|
|
|
JSACC_LIMIT
|
|
|
|
} JSAccessMode;
|
|
|
|
|
|
|
|
#define JSACC_TYPEMASK (JSACC_WRITE - 1)
|
|
|
|
|
|
|
|
/*
|
|
|
|
* This enum type is used to control the behavior of a JSObject property
|
|
|
|
* iterator function that has type JSNewEnumerate.
|
|
|
|
*/
|
|
|
|
typedef enum JSIterateOp {
|
|
|
|
/* Create new iterator state over enumerable properties. */
|
|
|
|
JSENUMERATE_INIT,
|
|
|
|
|
|
|
|
/* Create new iterator state over all properties. */
|
|
|
|
JSENUMERATE_INIT_ALL,
|
|
|
|
|
|
|
|
/* Iterate once. */
|
|
|
|
JSENUMERATE_NEXT,
|
|
|
|
|
|
|
|
/* Destroy iterator state. */
|
|
|
|
JSENUMERATE_DESTROY
|
|
|
|
} JSIterateOp;
|
|
|
|
|
2012-08-29 14:16:54 +08:00
|
|
|
/* See JSVAL_TRACE_KIND and JSTraceCallback in jsapi.h. */
|
|
|
|
typedef enum {
|
|
|
|
JSTRACE_OBJECT,
|
|
|
|
JSTRACE_STRING,
|
|
|
|
JSTRACE_SCRIPT,
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Trace kinds internal to the engine. The embedding can only them if it
|
|
|
|
* implements JSTraceCallback.
|
|
|
|
*/
|
2013-01-09 13:42:21 +08:00
|
|
|
JSTRACE_IONCODE,
|
2012-08-29 14:16:54 +08:00
|
|
|
#if JS_HAS_XML_SUPPORT
|
|
|
|
JSTRACE_XML,
|
2012-05-27 22:53:48 +08:00
|
|
|
#endif
|
2012-08-29 14:16:54 +08:00
|
|
|
JSTRACE_SHAPE,
|
|
|
|
JSTRACE_BASE_SHAPE,
|
|
|
|
JSTRACE_TYPE_OBJECT,
|
|
|
|
JSTRACE_LAST = JSTRACE_TYPE_OBJECT
|
|
|
|
} JSGCTraceKind;
|
2012-05-27 22:53:48 +08:00
|
|
|
|
2013-04-10 11:19:43 +08:00
|
|
|
/* Struct typedefs and class forward declarations. */
|
2012-08-29 14:16:54 +08:00
|
|
|
typedef struct JSClass JSClass;
|
|
|
|
typedef struct JSCompartment JSCompartment;
|
|
|
|
typedef struct JSConstDoubleSpec JSConstDoubleSpec;
|
|
|
|
typedef struct JSContext JSContext;
|
|
|
|
typedef struct JSCrossCompartmentCall JSCrossCompartmentCall;
|
|
|
|
typedef struct JSErrorReport JSErrorReport;
|
|
|
|
typedef struct JSExceptionState JSExceptionState;
|
|
|
|
typedef struct JSFunctionSpec JSFunctionSpec;
|
|
|
|
typedef struct JSIdArray JSIdArray;
|
|
|
|
typedef struct JSLocaleCallbacks JSLocaleCallbacks;
|
|
|
|
typedef struct JSObject JSObject;
|
|
|
|
typedef struct JSObjectMap JSObjectMap;
|
|
|
|
typedef struct JSPrincipals JSPrincipals;
|
|
|
|
typedef struct JSPropertyDescriptor JSPropertyDescriptor;
|
|
|
|
typedef struct JSPropertyName JSPropertyName;
|
|
|
|
typedef struct JSPropertySpec JSPropertySpec;
|
|
|
|
typedef struct JSRuntime JSRuntime;
|
|
|
|
typedef struct JSSecurityCallbacks JSSecurityCallbacks;
|
|
|
|
typedef struct JSStackFrame JSStackFrame;
|
|
|
|
typedef struct JSStructuredCloneCallbacks JSStructuredCloneCallbacks;
|
|
|
|
typedef struct JSStructuredCloneReader JSStructuredCloneReader;
|
|
|
|
typedef struct JSStructuredCloneWriter JSStructuredCloneWriter;
|
|
|
|
typedef struct JSTracer JSTracer;
|
2012-06-26 23:26:16 +08:00
|
|
|
|
2012-08-29 14:16:54 +08:00
|
|
|
#ifdef __cplusplus
|
|
|
|
class JSFlatString;
|
2013-04-10 11:19:43 +08:00
|
|
|
class JSFunction;
|
|
|
|
class JSScript;
|
2013-01-09 13:42:21 +08:00
|
|
|
class JSStableString; // long story
|
2012-08-29 14:16:54 +08:00
|
|
|
class JSString;
|
|
|
|
#else
|
|
|
|
typedef struct JSFlatString JSFlatString;
|
2013-04-10 11:19:43 +08:00
|
|
|
typedef struct JSFunction JSFunction;
|
|
|
|
typedef struct JSScript JSScript;
|
2012-08-29 14:16:54 +08:00
|
|
|
typedef struct JSString JSString;
|
|
|
|
#endif /* !__cplusplus */
|
2012-06-26 23:26:16 +08:00
|
|
|
|
2012-08-29 14:16:54 +08:00
|
|
|
#ifdef JS_THREADSAFE
|
|
|
|
typedef struct PRCallOnceType JSCallOnceType;
|
2012-05-27 22:53:48 +08:00
|
|
|
#else
|
2012-08-29 14:16:54 +08:00
|
|
|
typedef JSBool JSCallOnceType;
|
2012-06-26 23:26:16 +08:00
|
|
|
#endif
|
2012-08-29 14:16:54 +08:00
|
|
|
typedef JSBool (*JSInitCallback)(void);
|
2012-06-26 23:26:16 +08:00
|
|
|
|
2012-08-29 14:16:54 +08:00
|
|
|
#ifdef __cplusplus
|
2012-06-26 23:26:16 +08:00
|
|
|
|
2013-01-09 13:42:21 +08:00
|
|
|
namespace js {
|
2012-08-29 14:16:54 +08:00
|
|
|
|
|
|
|
template <typename T>
|
2012-10-19 11:15:23 +08:00
|
|
|
class Rooted;
|
2012-08-29 14:16:54 +08:00
|
|
|
|
|
|
|
class SkipRoot;
|
|
|
|
|
|
|
|
enum ThingRootKind
|
|
|
|
{
|
|
|
|
THING_ROOT_OBJECT,
|
|
|
|
THING_ROOT_SHAPE,
|
|
|
|
THING_ROOT_BASE_SHAPE,
|
|
|
|
THING_ROOT_TYPE_OBJECT,
|
|
|
|
THING_ROOT_STRING,
|
|
|
|
THING_ROOT_SCRIPT,
|
2012-10-19 11:15:23 +08:00
|
|
|
THING_ROOT_XML,
|
2012-08-29 14:16:54 +08:00
|
|
|
THING_ROOT_ID,
|
2012-10-19 11:15:23 +08:00
|
|
|
THING_ROOT_PROPERTY_ID,
|
2012-08-29 14:16:54 +08:00
|
|
|
THING_ROOT_VALUE,
|
2012-10-19 11:15:23 +08:00
|
|
|
THING_ROOT_TYPE,
|
2013-01-09 13:42:21 +08:00
|
|
|
THING_ROOT_BINDINGS,
|
2012-08-29 14:16:54 +08:00
|
|
|
THING_ROOT_LIMIT
|
|
|
|
};
|
|
|
|
|
2012-10-31 11:03:42 +08:00
|
|
|
template <typename T>
|
|
|
|
struct RootKind;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Specifically mark the ThingRootKind of externally visible types, so that
|
|
|
|
* JSAPI users may use JSRooted... types without having the class definition
|
|
|
|
* available.
|
|
|
|
*/
|
2013-01-09 13:42:21 +08:00
|
|
|
template<typename T, ThingRootKind Kind>
|
|
|
|
struct SpecificRootKind
|
|
|
|
{
|
|
|
|
static ThingRootKind rootKind() { return Kind; }
|
|
|
|
};
|
|
|
|
|
|
|
|
template <> struct RootKind<JSObject *> : SpecificRootKind<JSObject *, THING_ROOT_OBJECT> {};
|
|
|
|
template <> struct RootKind<JSFunction *> : SpecificRootKind<JSFunction *, THING_ROOT_OBJECT> {};
|
|
|
|
template <> struct RootKind<JSString *> : SpecificRootKind<JSString *, THING_ROOT_STRING> {};
|
|
|
|
template <> struct RootKind<JSScript *> : SpecificRootKind<JSScript *, THING_ROOT_SCRIPT> {};
|
|
|
|
template <> struct RootKind<jsid> : SpecificRootKind<jsid, THING_ROOT_ID> {};
|
|
|
|
template <> struct RootKind<JS::Value> : SpecificRootKind<JS::Value, THING_ROOT_VALUE> {};
|
2012-10-31 11:03:42 +08:00
|
|
|
|
2012-08-29 14:16:54 +08:00
|
|
|
struct ContextFriendFields {
|
|
|
|
JSRuntime *const runtime;
|
|
|
|
|
2013-04-10 11:19:43 +08:00
|
|
|
/* The current compartment. */
|
|
|
|
JSCompartment *compartment;
|
|
|
|
|
|
|
|
explicit ContextFriendFields(JSRuntime *rt)
|
|
|
|
: runtime(rt), compartment(NULL)
|
|
|
|
{ }
|
2012-08-29 14:16:54 +08:00
|
|
|
|
|
|
|
static const ContextFriendFields *get(const JSContext *cx) {
|
|
|
|
return reinterpret_cast<const ContextFriendFields *>(cx);
|
|
|
|
}
|
|
|
|
|
|
|
|
static ContextFriendFields *get(JSContext *cx) {
|
|
|
|
return reinterpret_cast<ContextFriendFields *>(cx);
|
|
|
|
}
|
|
|
|
|
2012-10-19 11:15:23 +08:00
|
|
|
#if defined(JSGC_ROOT_ANALYSIS) || defined(JSGC_USE_EXACT_ROOTING)
|
2012-08-29 14:16:54 +08:00
|
|
|
/*
|
|
|
|
* Stack allocated GC roots for stack GC heap pointers, which may be
|
|
|
|
* overwritten if moved during a GC.
|
|
|
|
*/
|
2012-10-19 11:15:23 +08:00
|
|
|
Rooted<void*> *thingGCRooters[THING_ROOT_LIMIT];
|
|
|
|
#endif
|
2012-08-29 14:16:54 +08:00
|
|
|
|
2012-10-19 11:15:23 +08:00
|
|
|
#if defined(DEBUG) && defined(JS_GC_ZEAL) && defined(JSGC_ROOT_ANALYSIS) && !defined(JS_THREADSAFE)
|
2012-08-29 14:16:54 +08:00
|
|
|
/*
|
|
|
|
* Stack allocated list of stack locations which hold non-relocatable
|
|
|
|
* GC heap pointers (where the target is rooted somewhere else) or integer
|
|
|
|
* values which may be confused for GC heap pointers. These are used to
|
|
|
|
* suppress false positives which occur when a rooting analysis treats the
|
|
|
|
* location as holding a relocatable pointer, but have no other effect on
|
|
|
|
* GC behavior.
|
|
|
|
*/
|
|
|
|
SkipRoot *skipGCRooters;
|
2012-05-27 22:53:48 +08:00
|
|
|
#endif
|
2012-08-29 14:16:54 +08:00
|
|
|
};
|
2012-06-26 23:26:16 +08:00
|
|
|
|
2013-01-09 13:42:21 +08:00
|
|
|
struct RuntimeFriendFields {
|
|
|
|
/*
|
|
|
|
* If non-zero, we were been asked to call the operation callback as soon
|
|
|
|
* as possible.
|
|
|
|
*/
|
|
|
|
volatile int32_t interrupt;
|
|
|
|
|
|
|
|
/* Limit pointer for checking native stack consumption. */
|
|
|
|
uintptr_t nativeStackLimit;
|
|
|
|
|
2013-02-27 15:45:23 +08:00
|
|
|
RuntimeFriendFields()
|
|
|
|
: interrupt(0),
|
|
|
|
nativeStackLimit(0) { }
|
|
|
|
|
|
|
|
static const RuntimeFriendFields *get(const JSRuntime *rt) {
|
|
|
|
return reinterpret_cast<const RuntimeFriendFields *>(rt);
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
|
|
|
class PerThreadData;
|
|
|
|
|
|
|
|
struct PerThreadDataFriendFields
|
|
|
|
{
|
|
|
|
PerThreadDataFriendFields();
|
|
|
|
|
2013-01-09 13:42:21 +08:00
|
|
|
#if defined(JSGC_ROOT_ANALYSIS) || defined(JSGC_USE_EXACT_ROOTING)
|
|
|
|
/*
|
|
|
|
* Stack allocated GC roots for stack GC heap pointers, which may be
|
|
|
|
* overwritten if moved during a GC.
|
|
|
|
*/
|
|
|
|
Rooted<void*> *thingGCRooters[THING_ROOT_LIMIT];
|
|
|
|
#endif
|
|
|
|
|
2013-02-27 15:45:23 +08:00
|
|
|
static PerThreadDataFriendFields *get(js::PerThreadData *pt) {
|
|
|
|
return reinterpret_cast<PerThreadDataFriendFields *>(pt);
|
|
|
|
}
|
2013-01-09 13:42:21 +08:00
|
|
|
|
2013-02-27 15:45:23 +08:00
|
|
|
static PerThreadDataFriendFields *getMainThread(JSRuntime *rt) {
|
|
|
|
// mainThread must always appear directly after |RuntimeFriendFields|.
|
|
|
|
// Tested by a JS_STATIC_ASSERT in |jsfriendapi.cpp|
|
|
|
|
return reinterpret_cast<PerThreadDataFriendFields *>(
|
|
|
|
reinterpret_cast<char*>(rt) + sizeof(RuntimeFriendFields));
|
2013-01-09 13:42:21 +08:00
|
|
|
}
|
|
|
|
};
|
|
|
|
|
|
|
|
} /* namespace js */
|
2012-06-26 23:26:16 +08:00
|
|
|
|
2012-08-29 14:16:54 +08:00
|
|
|
#endif /* __cplusplus */
|
2012-05-27 22:53:48 +08:00
|
|
|
|
|
|
|
#endif /* jspubtd_h___ */
|