1.8.7

  • Revision slug: SpiderMonkey/1.8.7
  • Revision title: 1.8.7
  • Revision id: 26949
  • Created:
  • Creator: Waldo
  • Is current revision? No
  • Comment Remove all old stuff, stub out new stuff; 160 words added, 1431 words removed

Revision Content

{{ draft() }}

{{ jsapi_minversion_header("1.8.7") }}

These release notes are an incomplete draft and were initially seeded from the 1.8.5 release notes, so lots of the information here isn't actually new to SpiderMonkey 1.8.7.

The Mozilla JavaScript team is pleased to announce the release of SpiderMonkey 1.8.7. You can download full source code here: INSERT-ACTUAL-LINK-WHEN-THE-RELEASE-HAPPENS (MD5 checksum: INSERT-ACTUAL-HASH-HERE).

SpiderMonkey 1.8.7 is the JavaScript engine that shipped in Firefox 10.0. It continues to improve performance over previous SpiderMonkey releases, with ongoing JIT compilation work and with the introduction of type inference to enable faster JITted code.  It also contains new language and API features described in detail below.

Please let us know about your experiences with this release by posting in the mozilla.dev.tech.js-engine newsgroup. Or file bugs at bugzilla.mozilla.org under Product: Core, Component: JavaScript engine.

—INSERT-ACTUAL-RELEASE-DATE-HERE

Platform support

SpiderMonkey 1.8.7 is supported on all the platforms where Firefox 10 runs.

SpiderMonkey 1.8.7 includes a just-in-time compiler (JIT) that compiles JavaScript to machine code, for a significant speed increase. It is supported on x86, x86_64, and ARM architectures. On some other platforms (SPARC), the JIT is provided but not supported.  On all other platforms the JIT is simply disabled; JavaScript code runs in an interpreter, as in previous versions. It's the same language, just not as fast.

Migrating to SpiderMonkey 1.8.7

The following features in earlier versions of SpiderMonkey have been dropped.

  • ...insert removed features here...

SpiderMonkey 1.8.7 is not binary-compatible with previous releases, nor is it source-code compatible. Many JSAPI types, functions, and callback signatures have changed, though most of them still have the same names and do the same things. Applications will need significant changes, but most of those changes will be detected by the C/C++ compiler, so they are easy to detect and updating the code is a fairly straightforward job. Here is a list of the most significant changes.

These and other changes are explained in detail below.

New JavaScript language features

JavaScript 1.8.5 adds support for ECMAScript Edition 5, including ES5 strict mode. For details, see New in JavaScript 1.8.5.  Note that there are a very small number of incompatibilities between ES5 and and ES3, the version of ECMAScript supported by SpiderMonkey versions 1.5 through 1.8. These are discussed in Annex E of the ES5 specification.

Garbage Collection

SpiderMonkey 1.8.5 introduces a conservative stack-scanning garbage collector. Unlike the exact garbage collector, the new garbage collector will scan the C stack and registers in your embedding, looking for bits that it can treat as potential GC roots. The approach eliminates the need for the JS_EnterLocalRootScope API, and in many cases the need to explicitly root GC things or use the "root as you go" approach popular with earlier SpiderMonkey releases.  Since this is a conservative collector, it will often find "garbage" addresses which can trigger warnings from certain code analysis tools.  If you are running valgrind on your embedding, be sure to build SpiderMonkey with the --enable-valgrind option to suppress superflous error messages triggered by the garbage collector.  This also means that objects will be finalized in a non-deterministic order in SpiderMonkey 1.8.5. This is not a bug, and, any embedding which depends upon deterministic finalization is fatally flawed.

Typed Rooting API

The rooting API has been changed from an error-prone void ** interface to an interface which accepts pointers to specific types.  JS_AddRoot has been replaced by JS_AddObjectRoot, JS_AddValueRoot and JS_AddStringRoot; similar changes were made for JS_AddNamedRoot and JS_RemoveRoot.  Since jsdoubles are now stored in the jsval, instead of on the heap, we no longer need to define roots for them.

Compartments

SpiderMonkey 1.8.5 introduces the concept of compartments. A compartment is a global object, a context, and a set of related objects with no outside references (CrossCompartment wrappers excepted). The new garbage collector can perform per-container garbage collection, which can be a significant performance improvement for certain workloads.  No compartment may execute JS code or call into JSAPI on two OS threads at the same time. For more information, see SpiderMonkey compartments.

Type Changes

jsval

The base data type, jsval, which represents all possible values in JavaScript, has changed from 32- to 64-bits wide, and the underlying representation has changed from a C integer type to a C struct. This change to a struct means that certain tricks, such as writing switch statements in C with jsval cases are no longer legal. Additionally, because not all fields are used by all jsvals, it is no longer safe to compare jsvals as though they were C values. Instead, jsvals should be converted to their C equivalents with the appropriate JSVAL_TO_* macro and then compared.

JSAPI no longer represents floating-point numbers (and integers more than 31 bits long) as pointers to jsdouble; instead, the jsdouble value is directly stored in the jsval.  This affects macros like DOUBLE_TO_JSVAL and JSVAL_TO_DOUBLE, which now operate directly on jsdouble rather than jsdouble pointers.

Previous SpiderMonkey versions usually represented integer values smaller than 2^31 as jsvals encoding jsint; e.g. so that JSVAL_IS_INT was true. While this was never specified behaviour, it is no longer true; numeric values which are integers are frequently encoded as jsdouble inside the jsval.  Embedders must be careful when converting numbers from jsvals into C. Note also that SpiderMonkey can now fit a full 32-bit integer (jsint) inside a jsval without promoting to a jsdouble.

Global Objects

Global objects have been specialized, and must be be created with either JS_NewGlobalObject or JS_NewCompartmentAndGlobalObject.  JS_NewObject and JS_NewObjectWithGivenProto remain the correct APIs for creating other objects. Global objects must also have the JSCLASS_GLOBAL_FLAGS flag set. Merely setting JSCLASS_IS_GLOBAL is insufficient.

New C APIs

New C++ helpers

While JSAPI remains a C API, the engine is now implemented in C++. Some C++ helpers have been introduced into the API, to help embedders writing C++ projects.  Please note that SpiderMonkey reserves the JS:: namespace for itself.

  • ...list new C++ helpers here...

Obsolete APIs

  • ...list obsolete methods/structs/APIs here...

Deleted APIs

  • ...list deleted methods/structs/API here...

API changes

Break out and discuss all API changes here...

Change the first

Description of change the first...

JavaScript shell changes

Detail added/removed methods here...

Known Issues

Detail any known issues here...

Future Direction

INCLUDE-FOLLOWUP-ON-EXPERIMENTAL-LIBRARY-VERSIONING-SCHEME-HERE

SpiderMonkey embedders should also be aware that

  • Mozilla has no plans to keep the JSAPI, nor the JSDBGAPI stable for embedders. We have chosen to concentrate on performance and correctness as primary concerns instead.
  • The team is considering the removal of TinyIDs
  • JS_THREADSAFE is going away, with future versions supporting only thread-safe builds
  • A new debugging API is on the way to replace JSD.

Release Notes Errata

This is a list of changes which need to be made to the release notes ASAP. Feel free to fix any problems you spot -- this is a Wiki!

  • Don't add anything here -- this is for after the release notes are completed.  :-)

Revision Source

<p>{{ draft() }}</p>
<p>{{ jsapi_minversion_header("1.8.7") }}</p>
<div class="note" style="color: black;"> <p><strong>These release notes are an incomplete draft and were initially seeded from the 1.8.5 release notes, so lots of the information here isn't actually new to SpiderMonkey 1.8.7.</strong></p> <p>The Mozilla JavaScript team is pleased to announce the release of <strong>SpiderMonkey 1.8.7</strong>. You can download full source code here: INSERT-ACTUAL-LINK-WHEN-THE-RELEASE-HAPPENS (MD5 checksum: <code>INSERT-ACTUAL-HASH-HERE</code>).</p> <p>SpiderMonkey 1.8.7 is the JavaScript engine that shipped in Firefox 10.0. It continues to improve performance over previous SpiderMonkey releases, with ongoing JIT compilation work and with the introduction of type inference to enable faster JITted code.  It also contains new language and API features described in detail below.</p> <p>Please let us know about your experiences with this release by posting in the <a class="link-news" href="news://news.mozilla.org/mozilla.dev.tech.js-engine">mozilla.dev.tech.js-engine newsgroup</a>. Or file bugs at <a class="link-https" href="https://bugzilla.mozilla.org/">bugzilla.mozilla.org</a> under Product: Core, Component: JavaScript engine.</p> <p>—INSERT-ACTUAL-RELEASE-DATE-HERE</p>
</div>
<h2>Platform support</h2>
<p>SpiderMonkey 1.8.7 is supported on all the platforms where Firefox 10 runs.</p>
<p>SpiderMonkey 1.8.7 includes a just-in-time compiler (JIT) that compiles JavaScript to machine code, for a significant speed increase. It is supported on x86, x86_64, and ARM architectures. On some other platforms (SPARC), the JIT is provided but not supported.  On all other platforms the JIT is simply disabled; JavaScript code runs in an interpreter, as in previous versions. It's the same language, just not as fast.</p>
<h2>Migrating to SpiderMonkey 1.8.7</h2>
<p>The following features in earlier versions of SpiderMonkey have been dropped.</p>
<ul> <li>...insert removed features here...</li>
</ul>
<p>SpiderMonkey 1.8.7 is not binary-compatible with previous releases, nor is it source-code compatible. Many JSAPI types, functions, and callback signatures have changed, though most of them still have the same names and do the same things. Applications will need significant changes, but most of those changes will be detected by the C/C++ compiler, so they are easy to detect and updating the code is a fairly straightforward job. Here is a list of the most significant changes.</p>
<ul> <li>The <a href="/en/SpiderMonkey/JSAPI_Reference/JS_SealObject" title="JS_SealObject"><code>JS_SealObject</code></a> method has been removed; the new <a href="/en/SpiderMonkey/JSAPI_Reference/JS_FreezeObject" title="JS_FreezeObject"><code>JS_FreezeObject</code></a> and <a href="/en/SpiderMonkey/JSAPI_Reference/JS_DeepFreezeObject" title="JS_SealObject"><code>JS_DeepFreezeObject</code></a> methods provide approximately the same functionality and should be used instead.</li>
</ul>
<p>These and other changes are explained in detail below.</p>
<h2>New JavaScript language features</h2>
<p>JavaScript 1.8.5 adds support for ECMAScript Edition 5, including ES5 strict mode. For details, see <a class="internal" href="/en/JavaScript/New_in_JavaScript/1.8.5" title="en/JavaScript/New in JavaScript/1.8.5">New in JavaScript 1.8.5</a>.  Note that there are a very small number of incompatibilities between ES5 and and ES3, the version of ECMAScript supported by SpiderMonkey versions 1.5 through 1.8. These are discussed in Annex E of the ES5 specification.</p>
<h2>Garbage Collection</h2>
<p>SpiderMonkey 1.8.5 introduces a conservative stack-scanning garbage collector. Unlike the exact garbage collector, the new garbage collector will scan the C stack and registers in your embedding, looking for bits that it can treat as potential GC roots. The approach eliminates the need for the JS_EnterLocalRootScope API, and in many cases the need to explicitly root GC things or use the "root as you go" approach popular with earlier SpiderMonkey releases.  Since this is a conservative collector, it will often find "garbage" addresses which can trigger warnings from certain code analysis tools.  If you are running valgrind on your embedding, be sure to build SpiderMonkey with the --enable-valgrind option to suppress superflous error messages triggered by the garbage collector.  This also means that objects will be finalized in a non-deterministic order in SpiderMonkey 1.8.5. This is not a bug, and, any embedding which depends upon deterministic finalization is fatally flawed.</p>
<h4>Typed Rooting API</h4>
<p>The rooting API has been changed from an error-prone void ** interface to an interface which accepts pointers to specific types.  JS_AddRoot has been replaced by JS_AddObjectRoot, JS_AddValueRoot and JS_AddStringRoot; similar changes were made for JS_AddNamedRoot and JS_RemoveRoot.  Since jsdoubles are now stored in the jsval, instead of on the heap, we no longer need to define roots for them.</p>
<h2>Compartments</h2>
<p>SpiderMonkey 1.8.5 introduces the concept of compartments. A compartment is a global object, a context, and a set of related objects with no outside references (CrossCompartment wrappers excepted). The new garbage collector can perform per-container garbage collection, which can be a significant performance improvement for certain workloads.  No compartment may execute JS code or call into JSAPI on two OS threads at the same time. For more information, see <a href="/en/SpiderMonkey/SpiderMonkey_compartments" title="https://developer.mozilla.org/en/SpiderMonkey/spidermonkey_compartments">SpiderMonkey compartments</a>.</p>
<h2>Type Changes</h2>
<h4>jsval</h4>
<p>The base data type, jsval, which represents all possible values in JavaScript, has changed from 32- to 64-bits wide, and the underlying representation has changed from a C integer type to a C struct. This change to a struct means that certain tricks, such as writing switch statements in C with jsval cases are no longer legal. Additionally, because not all fields are used by all jsvals, it is no longer safe to compare jsvals as though they were C values. Instead, jsvals should be converted to their C equivalents with the appropriate JSVAL_TO_* macro and then compared.</p>
<p>JSAPI no longer represents floating-point numbers (and integers more than 31 bits long) as pointers to jsdouble; instead, the jsdouble value is directly stored in the jsval.  This affects macros like DOUBLE_TO_JSVAL and JSVAL_TO_DOUBLE, which now operate directly on jsdouble rather than jsdouble pointers.</p>
<p>Previous SpiderMonkey versions usually represented integer values smaller than 2^31 as jsvals encoding jsint; e.g. so that JSVAL_IS_INT was true. While this was never specified behaviour, it is no longer true; numeric values which are integers are frequently encoded as jsdouble inside the jsval.  Embedders must be careful when converting numbers from jsvals into C. Note also that SpiderMonkey can now fit a full 32-bit integer (jsint) inside a jsval without promoting to a jsdouble.</p>
<h2>Global Objects</h2>
<p>Global objects have been specialized, and must be be created with either JS_NewGlobalObject or JS_NewCompartmentAndGlobalObject.  <a href="/en/SpiderMonkey/JSAPI_Reference/JS_NewObject" title="https://developer.mozilla.org/En/JS_NewObject">JS_NewObject</a> and <a href="/en/SpiderMonkey/JSAPI_Reference/JS_NewObject" title="https://developer.mozilla.org/En/JS_NewObject">JS_NewObjectWithGivenProto</a> remain the correct APIs for creating other objects. Global objects must also have the <a href="/en/SpiderMonkey/JSAPI_Reference/JSClass.flags" title="https://developer.mozilla.org/en/SpiderMonkey/JSAPI_Reference/JSClass.flags">JSCLASS_GLOBAL_FLAGS</a> flag set. Merely setting JSCLASS_IS_GLOBAL is insufficient.</p>
<h2 style="position: static; z-index: auto; ">New C APIs</h2>
<ul style="-moz-column-count:3;"> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_ASSERT_STRING_IS_FLAT" title="en/SpiderMonkey/JSAPI Reference/JS ASSERT_STRING_IS_FLAT"><code>JS_ASSERT_STRING_IS_FLAT</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_AddRoot" title="https://developer.mozilla.org/En/JS_AddRoot"><code>JS_AddGCThingRoot</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_AddRoot" title="https://developer.mozilla.org/En/JS_AddRoot"><code>JS_AddNamedGCThingRoot</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_AddRoot" title="https://developer.mozilla.org/En/JS_AddRoot"><code>JS_AddNamedObjectRoot</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_AddRoot" title="https://developer.mozilla.org/En/JS_AddRoot"><code>JS_AddNamedStringRoot</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_AddRoot" title="https://developer.mozilla.org/En/JS_AddRoot"><code>JS_AddNamedValueRoot</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_AddRoot" title="https://developer.mozilla.org/En/JS_AddRoot"><code>JS_AddObjectRoot</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_AddRoot" title="https://developer.mozilla.org/En/JS_AddRoot"><code>JS_AddStringRoot</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_AddRoot" title="https://developer.mozilla.org/En/JS_AddRoot"><code>JS_AddValueRoot</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_AlreadyHasOwnProperty" title="en/SpiderMonkey/JSAPI Reference/JS AlreadyHasOwnPropertyById"><code>JS_AlreadyHasOwnPropertyById</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_AnchorPtr" title="en/SpiderMonkey/JSAPI Reference/JS AnchorPtr"><code>JS_AnchorPtr</code></a><a href="/en/SpiderMonkey/JSAPI_Reference/JS_BEGIN_EXTERN_C" title="en/SpiderMonkey/JSAPI Reference/JS BEGIN_EXTERN_C"><br> <code> </code></a></li> <li><code><a href="/en/SpiderMonkey/JSAPI_Reference/JS_BeginJSONParse" title="en/SpiderMonkey/JSAPI Reference/JS BeginJSONParse">JS_BeginJSONParse</a> (removed in future releases, replaced with <a href="/en/SpiderMonkey/JSAPI_Reference/JS_ParseJSON" title="en/SpiderMonkey/JSAPI Reference/JS ParseJSON">JS_ParseJSON</a>)</code></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_CompileFileHandleForPrincipalsVersion" title="en/SpiderMonkey/JSAPI Reference/JS CompileFileHandleForPrincipalsVersion"><code>JS_CompileFileHandleForPrincipalsVersion</code></a></li> <li><a href="/En/SpiderMonkey/JSAPI_Reference/JS_CompileScriptForPrincipalsVersion" title="en/SpiderMonkey/JSAPI Reference/JS CompileScriptForPrincipalsVersion"><code>JS_CompileScriptForPrincipalsVersion</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_CompileUCFunctionForPrincipalsVersion" title="en/SpiderMonkey/JSAPI Reference/JS CompileUCFunctionForPrincipalsVersion"><code>JS_CompileUCFunctionForPrincipalsVersion</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_CompileUCScriptForPrincipalsVersion" title="en/SpiderMonkey/JSAPI Reference/JS CompileUCScriptForPrincipalsVersion"><code>JS_CompileUCScriptForPrincipalsVersion</code></a></li> <li><code><a href="/en/SpiderMonkey/JSAPI_Reference/JS_ConsumeJSONText" title="en/SpiderMonkey/JSAPI Reference/JS ConsumeJSONText">JS_ConsumeJSONText</a> (removed in future releases, replaced with <a href="/en/SpiderMonkey/JSAPI_Reference/JS_ParseJSON" title="en/SpiderMonkey/JSAPI Reference/JS ParseJSON">JS_ParseJSON</a>)</code></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_DecompileScriptObject" title="en/SpiderMonkey/JSAPI Reference/JS DecompileScriptObject"><code>JS_DecompileScriptObject</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_DeepFreezeObject" title="en/SpiderMonkey/JSAPI Reference/JS DeepFreezeObject"><code>JS_DeepFreezeObject</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_DefineFunctionById" title="en/SpiderMonkey/JSAPI Reference/JS DefineFunctionById"><code>JS_DefineFunctionById</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_DefineOwnProperty" title="en/SpiderMonkey/JSAPI Reference/JS DefineOwnProperty"><code>JS_DefineOwnProperty</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_DefineProperty" title="en/SpiderMonkey/JSAPI Reference/JS DefinePropertyById"><code>JS_DefinePropertyById</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_DeleteProperty" title="en/SpiderMonkey/JSAPI Reference/JS DeletePropertyById"><code>JS_DeletePropertyById</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_DeleteProperty2" title="en/SpiderMonkey/JSAPI Reference/JS DeletePropertyById2"><code>JS_DeletePropertyById2</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_DoubleIsInt32" title="en/SpiderMonkey/JSAPI Reference/JS DoubleIsInt32"><code>JS_DoubleIsInt32</code></a><a href="/en/SpiderMonkey/JSAPI_Reference/JS_END_EXTERN_C" title="en/SpiderMonkey/JSAPI Reference/JS END_EXTERN_C"><br> <code> </code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_GetStringBytes" title="https://developer.mozilla.org/en/JS_GetStringBytes"><code>JS_EncodeStringToBuffer</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_EnterCrossCompartmentCall" title="en/SpiderMonkey/JSAPI Reference/JS EnterCrossCompartmentCall"><code>JS_EnterCrossCompartmentCall</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_EvaluateScriptForPrincipalsVersion" title="en/SpiderMonkey/JSAPI Reference/JS EvaluateScriptForPrincipalsVersion"><code>JS_EvaluateScriptForPrincipalsVersion</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_EvaluateUCScriptForPrincipalsVersion" title="en/SpiderMonkey/JSAPI Reference/JS EvaluateUCScriptForPrincipalsVersion"><code>JS_EvaluateUCScriptForPrincipalsVersion</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_ExecuteRegExp" title="en/SpiderMonkey/JSAPI Reference/JS ExecuteRegExp"><code>JS_ExecuteRegExp</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_ExecuteRegExpNoStatics" title="en/SpiderMonkey/JSAPI Reference/JS ExecuteRegExpNoStatics"><code>JS_ExecuteRegExpNoStatics</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_ExecuteScriptVersion" title="en/SpiderMonkey/JSAPI Reference/JS ExecuteScriptVersion"><code>JS_ExecuteScriptVersion</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_FORGET_STRING_FLATNESS" title="en/SpiderMonkey/JSAPI Reference/JS FORGET_STRING_FLATNESS"><code>JS_FORGET_STRING_FLATNESS</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_FileEscapedString" title="en/SpiderMonkey/JSAPI Reference/JS FileEscapedString"><code>JS_FileEscapedString</code></a></li> <li><code><a href="/en/SpiderMonkey/JSAPI_Reference/JS_FinishJSONParse" title="en/SpiderMonkey/JSAPI Reference/JS FinishJSONParse">JS_FinishJSONParse</a> (removed in future releases, replaced with <a href="/en/SpiderMonkey/JSAPI_Reference/JS_ParseJSON" title="en/SpiderMonkey/JSAPI Reference/JS ParseJSON">JS_ParseJSON</a>)</code></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_FlatStringEqualsAscii" title="en/SpiderMonkey/JSAPI Reference/JS FlatStringEqualsAscii"><code>JS_FlatStringEqualsAscii</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_FlattenString" title="en/SpiderMonkey/JSAPI Reference/JS FlattenString"><code>JS_FlattenString</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_FlushCaches" title="en/SpiderMonkey/JSAPI Reference/JS FlushCaches"><code>JS_FlushCaches</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_FreezeObject" title="en/SpiderMonkey/JSAPI Reference/JS FreezeObject"><code>JS_FreezeObject</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_GetCompartmentPrivate" title="en/SpiderMonkey/JSAPI Reference/JS GetCompartmentPrivate"><code>JS_GetCompartmentPrivate</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_GetEmptyString" title="en/SpiderMonkey/JSAPI Reference/JS GetEmptyString"><code>JS_GetEmptyString</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_GetFlatStringChars" title="en/SpiderMonkey/JSAPI Reference/JS GetFlatStringChars"><code>JS_GetFlatStringChars</code></a></li> <li><a href="/En/SpiderMonkey/JSAPI_Reference/JS_GetGCParameter" title="en/SpiderMonkey/JSAPI Reference/JS GetGCParameter"><code>JS_GetGCParameter</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_GetGCParameterForThread" title="en/SpiderMonkey/JSAPI Reference/JS GetGCParameterForThread"><code>JS_GetGCParameterForThread</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_GetGlobalForScopeChain" title="en/SpiderMonkey/JSAPI Reference/JS GetGlobalForScopeChain"><code>JS_GetGlobalForScopeChain</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_GetInternedStringChars" title="en/SpiderMonkey/JSAPI Reference/JS GetInternedStringChars"><code>JS_GetInternedStringChars</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_GetInternedStringCharsAndLength" title="en/SpiderMonkey/JSAPI Reference/JS GetInternedStringCharsAndLength"><code>JS_GetInternedStringCharsAndLength</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_GetOwnPropertyDescriptor" title="en/SpiderMonkey/JSAPI Reference/JS GetOwnPropertyDescriptor"><code>JS_GetOwnPropertyDescriptor</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_GetPropertyAttrsGetterAndSetter" title="en/SpiderMonkey/JSAPI Reference/JS GetPropertyAttrsGetterAndSetterById"><code>JS_GetPropertyAttrsGetterAndSetterById</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_GetProperty" title="en/SpiderMonkey/JSAPI Reference/JS GetPropertyById"><code>JS_GetPropertyById</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_GetPropertyByIdDefault" title="en/SpiderMonkey/JSAPI Reference/JS GetPropertyByIdDefault"><code>JS_GetPropertyByIdDefault</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_GetPropertyDefault" title="en/SpiderMonkey/JSAPI Reference/JS GetPropertyDefault"><code>JS_GetPropertyDefault</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_GetPropertyDescriptorById" title="en/SpiderMonkey/JSAPI Reference/JS GetPropertyDescriptorById"><code>JS_GetPropertyDescriptorById</code></a></li> <li><a href="/En/SpiderMonkey/JSAPI_Reference/JS_GetSecurityCallbacks" title="en/SpiderMonkey/JSAPI Reference/JS GetRuntimeSecurityCallbacks"><code>JS_GetRuntimeSecurityCallbacks</code></a></li> <li><a href="/En/SpiderMonkey/JSAPI_Reference/JS_GetSecurityCallbacks" title="en/SpiderMonkey/JSAPI Reference/JS GetSecurityCallbacks"><code>JS_GetSecurityCallbacks</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_GetStringCharsAndLength" title="en/SpiderMonkey/JSAPI Reference/JS GetStringCharsAndLength"><code>JS_GetStringCharsAndLength</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_GetStringCharsZ" title="en/SpiderMonkey/JSAPI Reference/JS GetStringCharsZ"><code>JS_GetStringCharsZ</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_GetStringCharsZAndLength" title="en/SpiderMonkey/JSAPI Reference/JS GetStringCharsZAndLength"><code>JS_GetStringCharsZAndLength</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_GetStringEncodingLength" title="en/SpiderMonkey/JSAPI Reference/JS GetStringEncodingLength"><code>JS_GetStringEncodingLength</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_HasProperty" title="en/SpiderMonkey/JSAPI Reference/JS HasPropertyById"><code>JS_HasPropertyById</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_InitCTypesClass" title="en/SpiderMonkey/JSAPI Reference/JS InitCTypesClass"><code>JS_InitCTypesClass</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_InternJSString" title="en/SpiderMonkey/JSAPI Reference/JS InternJSString"><code>JS_InternJSString</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_IsConstructing_PossiblyWithGivenThisObject" title="en/SpiderMonkey/JSAPI Reference/JS IsConstructing_PossiblyWithGivenThisObject"><code>JS_IsConstructing_PossiblyWithGivenThisObject</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_IsExtensible" title="en/SpiderMonkey/JSAPI Reference/JS IsExtensible"><code>JS_IsExtensible</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_IsInRequest" title="en/SpiderMonkey/JSAPI Reference/JS IsInRequest"><code>JS_IsInRequest</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_LeaveCrossCompartmentCall" title="en/SpiderMonkey/JSAPI Reference/JS LeaveCrossCompartmentCall"><code>JS_LeaveCrossCompartmentCall</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_LookupProperty" title="en/SpiderMonkey/JSAPI Reference/JS LookupPropertyById"><code>JS_LookupPropertyById</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_LookupProperty" title="en/SpiderMonkey/JSAPI Reference/JS LookupPropertyWithFlagsById"><code>JS_LookupPropertyWithFlagsById</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_New" title="en/SpiderMonkey/JSAPI Reference/JS New"><code>JS_New</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_NewCompartmentAndGlobalObject" title="en/SpiderMonkey/JSAPI Reference/JS NewCompartmentAndGlobalObject"><code>JS_NewCompartmentAndGlobalObject</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_NewDateObject" title="en/SpiderMonkey/JSAPI Reference/JS NewDateObject"><code>JS_NewDateObject</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_NewDateObjectMsec" title="en/SpiderMonkey/JSAPI Reference/JS NewDateObjectMsec"><code>JS_NewDateObjectMsec</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Reference/JS_NewFunctionById" title="en/SpiderMonkey/JSAPI Reference/JS NewFunctionById"><code>JS_NewFunctionById</code></a></li> <li><a href="/en/SpiderMonkey/JSAPI_Re%3C/body" title="en/SpiderMonkey/JSAPI Reference/JS NewGlobalObject">body</a></li>
</ul>
<h2>New C++ helpers</h2>
<p>While JSAPI remains a C API, the engine is now implemented in C++. Some C++ helpers have been introduced into the API, to help embedders writing C++ projects.  Please note that SpiderMonkey reserves the JS:: namespace for itself.</p>
<ul> <li><code>...list new C++ helpers here...</code></li>
</ul>
<h2>Obsolete APIs</h2>
<ul> <li><code>...list obsolete methods/structs/APIs here...</code></li>
</ul>
<h2>Deleted APIs</h2>
<ul> <li><code>...list deleted methods/structs/API here...</code></li>
</ul>
<h2>API changes</h2>
<p>Break out and discuss all API changes here...</p>
<h4>Change the first</h4>
<p>Description of change the first...<a href="/en/SpiderMonkey/JSAPI_Reference/JS_GetStringBytes" title="en/SpiderMonkey/JSAPI Reference/JS GetStringBytes"><br> </a></p>
<h2>JavaScript shell changes</h2>
<p>Detail added/removed methods here...</p>
<h2>Known Issues</h2>
<p>Detail any known issues here...</p>
<h2>Future Direction</h2>
<p>INCLUDE-FOLLOWUP-ON-EXPERIMENTAL-LIBRARY-VERSIONING-SCHEME-HERE</p>
<p>SpiderMonkey embedders should also be aware that</p>
<ul> <li>Mozilla has no plans to keep the JSAPI, nor the JSDBGAPI stable for embedders. We have chosen to concentrate on performance and correctness as primary concerns instead.</li> <li>The team is considering the removal of TinyIDs</li> <li>JS_THREADSAFE is going away, with future versions supporting only thread-safe builds</li> <li>A new debugging API is on the way to replace JSD.</li>
</ul>
<h2>Release Notes Errata</h2>
<p>This is a list of changes which need to be made to the release notes ASAP. Feel free to fix any problems you spot -- this is a Wiki!</p>
<ul> <li>Don't add anything here -- this is for after the release notes are completed.  :-)</li>
</ul>
Revert to this revision