Source code
Revision control
Copy as Markdown
Other Tools
/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* 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
/*
* Options for JavaScript compilation.
*
* In the most common use case, a CompileOptions instance is allocated on the
* stack, and holds non-owning references to non-POD option values: strings,
* principals, objects, and so on. The code declaring the instance guarantees
* that such option values will outlive the CompileOptions itself: objects are
* otherwise rooted, principals have had their reference counts bumped, and
* strings won't be freed until the CompileOptions goes out of scope. In this
* situation, CompileOptions only refers to things others own, so it can be
* lightweight.
*
* In some cases, however, we need to hold compilation options with a
* non-stack-like lifetime. For example, JS::CompileOffThread needs to save
* compilation options where a worker thread can find them, then return
* immediately. The worker thread will come along at some later point, and use
* the options.
*
* The compiler itself just needs to be able to access a collection of options;
* it doesn't care who owns them, or what's keeping them alive. It does its
* own addrefs/copies/tracing/etc.
*
* Furthermore, in some cases compile options are propagated from one entity to
* another (e.g. from a script to a function defined in that script). This
* involves copying over some, but not all, of the options.
*
* So we have a class hierarchy that reflects these four use cases:
*
* - TransitiveCompileOptions is the common base class, representing options
* that should get propagated from a script to functions defined in that
* script. This class is abstract and is only ever used as a subclass.
*
* - ReadOnlyCompileOptions is the only subclass of TransitiveCompileOptions,
* representing a full set of compile options. It can be used by code that
* simply needs to access options set elsewhere, like the compiler. This
* class too is abstract and is only ever used as a subclass.
*
* - The usual CompileOptions class must be stack-allocated, and holds
* non-owning references to the filename, element, and so on. It's derived
* from ReadOnlyCompileOptions, so the compiler can use it.
*
* - OwningCompileOptions roots / copies / reference counts of all its values,
* and unroots / frees / releases them when it is destructed. It too is
* derived from ReadOnlyCompileOptions, so the compiler accepts it.
*/
#ifndef js_CompileOptions_h
#define js_CompileOptions_h
#include "mozilla/Assertions.h" // MOZ_ASSERT
#include "mozilla/MemoryReporting.h" // mozilla::MallocSizeOf
#include <stddef.h> // size_t
#include <stdint.h> // uint8_t, uint32_t
#include "jstypes.h" // JS_PUBLIC_API
#include "js/CharacterEncoding.h" // JS::ConstUTF8CharsZ
#include "js/ColumnNumber.h" // JS::ColumnNumberOneOrigin
#ifdef ENABLE_EXPLICIT_RESOURCE_MANAGEMENT
# include "js/Prefs.h" // JS::Prefs::*
#endif
#include "js/TypeDecls.h" // JS::MutableHandle (fwd)
namespace js {
class FrontendContext;
} // namespace js
namespace JS {
using FrontendContext = js::FrontendContext;
enum class AsmJSOption : uint8_t {
Enabled,
DisabledByAsmJSPref,
DisabledByLinker,
DisabledByNoWasmCompiler,
DisabledByDebugger,
};
#define FOREACH_DELAZIFICATION_STRATEGY(_) \
/* Do not delazify anything eagerly. */ \
_(OnDemandOnly) \
\
/* \
* Compare the stencil produced by concurrent depth first delazification and \
* on-demand delazification. Any differences would crash SpiderMonkey with \
* an assertion. \
*/ \
_(CheckConcurrentWithOnDemand) \
\
/* \
* Delazifiy functions in a depth first traversal of the functions. \
*/ \
_(ConcurrentDepthFirst) \
\
/* \
* Delazifiy functions strating with the largest function first. \
*/ \
_(ConcurrentLargeFirst) \
\
/* \
* Parse everything eagerly, from the first parse. \
* \
* NOTE: Either the Realm configuration or specialized VM operating modes \
* may disallow syntax-parse altogether. These conditions are checked in the \
* CompileOptions constructor. \
*/ \
_(ParseEverythingEagerly)
enum class DelazificationOption : uint8_t {
#define _ENUM_ENTRY(Name) Name,
FOREACH_DELAZIFICATION_STRATEGY(_ENUM_ENTRY)
#undef _ENUM_ENTRY
};
class JS_PUBLIC_API InstantiateOptions;
class JS_PUBLIC_API ReadOnlyDecodeOptions;
// Compilation-specific part of JS::ContextOptions which is supposed to be
// configured by user prefs.
class JS_PUBLIC_API PrefableCompileOptions {
public:
PrefableCompileOptions()
: importAttributes_(false),
sourcePragmas_(true),
#ifdef ENABLE_EXPLICIT_RESOURCE_MANAGEMENT
explicitResourceManagement_(
JS::Prefs::experimental_explicit_resource_management()),
#endif
throwOnAsmJSValidationFailure_(false) {
}
bool importAttributes() const { return importAttributes_; }
PrefableCompileOptions& setImportAttributes(bool enabled) {
importAttributes_ = enabled;
return *this;
}
#ifdef ENABLE_EXPLICIT_RESOURCE_MANAGEMENT
bool explicitResourceManagement() const {
return explicitResourceManagement_;
}
PrefableCompileOptions& setExplicitResourceManagement(bool enabled) {
explicitResourceManagement_ = enabled;
return *this;
}
#endif
// Enable/disable support for parsing '//(#@) source(Mapping)?URL=' pragmas.
bool sourcePragmas() const { return sourcePragmas_; }
PrefableCompileOptions& setSourcePragmas(bool flag) {
sourcePragmas_ = flag;
return *this;
}
AsmJSOption asmJSOption() const { return asmJSOption_; }
PrefableCompileOptions& setAsmJS(bool flag) {
asmJSOption_ =
flag ? AsmJSOption::Enabled : AsmJSOption::DisabledByAsmJSPref;
return *this;
}
PrefableCompileOptions& setAsmJSOption(AsmJSOption option) {
asmJSOption_ = option;
return *this;
}
bool throwOnAsmJSValidationFailure() const {
return throwOnAsmJSValidationFailure_;
}
PrefableCompileOptions& setThrowOnAsmJSValidationFailure(bool flag) {
throwOnAsmJSValidationFailure_ = flag;
return *this;
}
PrefableCompileOptions& toggleThrowOnAsmJSValidationFailure() {
throwOnAsmJSValidationFailure_ = !throwOnAsmJSValidationFailure_;
return *this;
}
#if defined(DEBUG) || defined(JS_JITSPEW)
template <typename Printer>
void dumpWith(Printer& print) const {
# define PrintFields_(Name) print(#Name, Name)
PrintFields_(importAttributes_);
PrintFields_(sourcePragmas_);
PrintFields_(throwOnAsmJSValidationFailure_);
# ifdef ENABLE_EXPLICIT_RESOURCE_MANAGEMENT
PrintFields_(explicitResourceManagement_);
# endif
# undef PrintFields_
switch (asmJSOption_) {
case AsmJSOption::Enabled:
print("asmJSOption_", "AsmJSOption::Enabled");
break;
case AsmJSOption::DisabledByAsmJSPref:
print("asmJSOption_", "AsmJSOption::DisabledByAsmJSPref");
break;
case AsmJSOption::DisabledByLinker:
print("asmJSOption_", "AsmJSOption::DisabledByLinker");
break;
case AsmJSOption::DisabledByNoWasmCompiler:
print("asmJSOption_", "AsmJSOption::DisabledByNoWasmCompiler");
break;
case AsmJSOption::DisabledByDebugger:
print("asmJSOption_", "AsmJSOption::DisabledByDebugger");
break;
}
}
#endif // defined(DEBUG) || defined(JS_JITSPEW)
private:
// ==== Syntax-related options. ====
bool importAttributes_ : 1;
// The context has specified that source pragmas should be parsed.
bool sourcePragmas_ : 1;
#ifdef ENABLE_EXPLICIT_RESOURCE_MANAGEMENT
// The context has specified that explicit resource management syntax
// should be parsed.
bool explicitResourceManagement_ : 1;
#endif
// ==== asm.js options. ====
bool throwOnAsmJSValidationFailure_ : 1;
AsmJSOption asmJSOption_ = AsmJSOption::DisabledByAsmJSPref;
};
/**
* The common base class for the CompileOptions hierarchy.
*
* Use this in code that needs to propagate compile options from one
* compilation unit to another.
*/
class JS_PUBLIC_API TransitiveCompileOptions {
friend class JS_PUBLIC_API ReadOnlyDecodeOptions;
protected:
// non-POD options:
JS::ConstUTF8CharsZ filename_;
JS::ConstUTF8CharsZ introducerFilename_;
const char16_t* sourceMapURL_ = nullptr;
// POD options:
// WARNING: When adding new fields, don't forget to add them to
// copyPODTransitiveOptions.
/**
* The Web Platform allows scripts to be loaded from arbitrary cross-origin
* sources. This allows an attack by which a malicious website loads a
* sensitive file (say, a bank statement) cross-origin (using the user's
* cookies), and sniffs the generated syntax errors (via a window.onerror
* handler) for juicy morsels of its contents.
*
* To counter this attack, HTML5 specifies that script errors should be
* sanitized ("muted") when the script is not same-origin with the global
* for which it is loaded. Callers should set this flag for cross-origin
* scripts, and it will be propagated appropriately to child scripts and
* passed back in JSErrorReports.
*/
bool mutedErrors_ = false;
// Either the Realm configuration or the compile request may force
// strict-mode.
bool forceStrictMode_ = false;
// The Realm of this script is configured to use fdlibm math library.
bool alwaysUseFdlibm_ = false;
// Flag used to bypass the filename validation callback.
// See also SetFilenameValidationCallback.
bool skipFilenameValidation_ = false;
bool hideScriptFromDebugger_ = false;
// If set, this script will be hidden from the debugger. The requirement
// is that once compilation is finished, a call to UpdateDebugMetadata will
// be made, which will update the SSO with the appropiate debug metadata,
// and expose the script to the debugger (if hideScriptFromDebugger_ isn't
// set)
bool deferDebugMetadata_ = false;
// Off-thread delazification strategy is used to tell off-thread tasks how the
// delazification should be performed. Multiple strategies are available in
// order to test different approaches to the concurrent delazification.
DelazificationOption eagerDelazificationStrategy_ =
DelazificationOption::OnDemandOnly;
friend class JS_PUBLIC_API InstantiateOptions;
public:
bool selfHostingMode = false;
bool discardSource = false;
bool sourceIsLazy = false;
bool allowHTMLComments = true;
bool nonSyntacticScope = false;
// Top-level await is enabled by default but is not supported for chrome
// modules loaded with ChromeUtils.importModule.
bool topLevelAwait = true;
// When decoding from XDR into a Stencil, directly reference data in the
// buffer (where possible) instead of copying it. This is an optional
// performance optimization, and may also reduce memory if the buffer is going
// remain alive anyways.
//
// NOTE: The XDR buffer must remain alive as long as the Stencil does. Special
// care must be taken that there are no addition shared references to
// the Stencil.
//
// NOTE: Instantiated GC things may still outlive the buffer as long as the
// Stencil was cleaned up. This is covers a typical case where a decoded
// Stencil is instantiated once and then thrown away.
bool borrowBuffer = false;
// Similar to `borrowBuffer`, but additionally the JSRuntime may directly
// reference data in the buffer for JS bytecode. The `borrowBuffer` flag must
// be set if this is set. This can be a memory optimization in multi-process
// architectures where a (read-only) XDR buffer is mapped into multiple
// processes.
//
// NOTE: When using this mode, the XDR buffer must live until JS_Shutdown is
// called. There is currently no mechanism to release the data sooner.
bool usePinnedBytecode = false;
// De-optimize ES module's top-level `var`s, in order to define all of them
// on the ModuleEnvironmentObject, instead of local slot.
//
// This is used for providing all global variables in Cu.import return value
// ESM-ification finishes.
//
// WARNING: This option will eventually be removed.
bool deoptimizeModuleGlobalVars = false;
PrefableCompileOptions prefableOptions_;
/**
* |introductionType| is a statically allocated C string. See JSScript.h
* for more information.
*/
const char* introductionType = nullptr;
unsigned introductionLineno = 0;
uint32_t introductionOffset = 0;
bool hasIntroductionInfo = false;
// WARNING: When adding new fields, don't forget to add them to
// copyPODTransitiveOptions.
protected:
TransitiveCompileOptions() = default;
// Set all POD options (those not requiring reference counts, copies,
// rooting, or other hand-holding) to their values in |rhs|.
void copyPODTransitiveOptions(const TransitiveCompileOptions& rhs);
bool isEagerDelazificationEqualTo(DelazificationOption val) const {
return eagerDelazificationStrategy() == val;
}
template <DelazificationOption... Values>
bool eagerDelazificationIsOneOf() const {
return (isEagerDelazificationEqualTo(Values) || ...);
}
public:
// Read-only accessors for non-POD options. The proper way to set these
// depends on the derived type.
bool mutedErrors() const { return mutedErrors_; }
bool alwaysUseFdlibm() const { return alwaysUseFdlibm_; }
bool forceFullParse() const {
return eagerDelazificationIsOneOf<
DelazificationOption::ParseEverythingEagerly>();
}
bool forceStrictMode() const { return forceStrictMode_; }
bool consumeDelazificationCache() const {
return eagerDelazificationIsOneOf<
DelazificationOption::ConcurrentDepthFirst,
DelazificationOption::ConcurrentLargeFirst>();
}
bool populateDelazificationCache() const {
return eagerDelazificationIsOneOf<
DelazificationOption::CheckConcurrentWithOnDemand,
DelazificationOption::ConcurrentDepthFirst,
DelazificationOption::ConcurrentLargeFirst>();
}
bool waitForDelazificationCache() const {
return eagerDelazificationIsOneOf<
DelazificationOption::CheckConcurrentWithOnDemand>();
}
bool checkDelazificationCache() const {
return eagerDelazificationIsOneOf<
DelazificationOption::CheckConcurrentWithOnDemand>();
}
DelazificationOption eagerDelazificationStrategy() const {
return eagerDelazificationStrategy_;
}
bool importAttributes() const { return prefableOptions_.importAttributes(); }
bool sourcePragmas() const { return prefableOptions_.sourcePragmas(); }
#ifdef ENABLE_EXPLICIT_RESOURCE_MANAGEMENT
bool explicitResourceManagement() const {
return prefableOptions_.explicitResourceManagement();
}
#endif
bool throwOnAsmJSValidationFailure() const {
return prefableOptions_.throwOnAsmJSValidationFailure();
}
AsmJSOption asmJSOption() const { return prefableOptions_.asmJSOption(); }
void setAsmJSOption(AsmJSOption option) {
prefableOptions_.setAsmJSOption(option);
}
JS::ConstUTF8CharsZ filename() const { return filename_; }
JS::ConstUTF8CharsZ introducerFilename() const { return introducerFilename_; }
const char16_t* sourceMapURL() const { return sourceMapURL_; }
const PrefableCompileOptions& prefableOptions() const {
return prefableOptions_;
}
TransitiveCompileOptions(const TransitiveCompileOptions&) = delete;
TransitiveCompileOptions& operator=(const TransitiveCompileOptions&) = delete;
#if defined(DEBUG) || defined(JS_JITSPEW)
template <typename Printer>
void dumpWith(Printer& print) const {
# define PrintFields_(Name) print(#Name, Name)
PrintFields_(filename_);
PrintFields_(introducerFilename_);
PrintFields_(sourceMapURL_);
PrintFields_(mutedErrors_);
PrintFields_(forceStrictMode_);
PrintFields_(alwaysUseFdlibm_);
PrintFields_(skipFilenameValidation_);
PrintFields_(hideScriptFromDebugger_);
PrintFields_(deferDebugMetadata_);
PrintFields_(eagerDelazificationStrategy_);
PrintFields_(selfHostingMode);
PrintFields_(discardSource);
PrintFields_(sourceIsLazy);
PrintFields_(allowHTMLComments);
PrintFields_(nonSyntacticScope);
PrintFields_(topLevelAwait);
PrintFields_(borrowBuffer);
PrintFields_(usePinnedBytecode);
PrintFields_(deoptimizeModuleGlobalVars);
PrintFields_(introductionType);
PrintFields_(introductionLineno);
PrintFields_(introductionOffset);
PrintFields_(hasIntroductionInfo);
# undef PrintFields_
prefableOptions_.dumpWith(print);
}
#endif // defined(DEBUG) || defined(JS_JITSPEW)
};
/**
* The class representing a full set of compile options.
*
* Use this in code that only needs to access compilation options created
* elsewhere, like the compiler. Don't instantiate this class (the constructor
* is protected anyway); instead, create instances only of the derived classes:
* CompileOptions and OwningCompileOptions.
*/
class JS_PUBLIC_API ReadOnlyCompileOptions : public TransitiveCompileOptions {
public:
// POD options.
// Line number of the first character (1-origin).
uint32_t lineno = 1;
// Column number of the first character in UTF-16 code units.
JS::ColumnNumberOneOrigin column;
// The offset within the ScriptSource's full uncompressed text of the first
// character we're presenting for compilation with this CompileOptions.
//
// When we compile a lazy script, we pass the compiler only the substring of
// the source the lazy function occupies. With chunked decompression, we may
// not even have the complete uncompressed source present in memory. But parse
// node positions are offsets within the ScriptSource's full text, and
// BaseScript indicate their substring of the full source by its starting and
// ending offsets within the full text. This scriptSourceOffset field lets the
// frontend convert between these offsets and offsets within the substring
// presented for compilation.
unsigned scriptSourceOffset = 0;
// These only apply to non-function scripts.
bool isRunOnce = false;
bool noScriptRval = false;
protected:
ReadOnlyCompileOptions() = default;
void copyPODNonTransitiveOptions(const ReadOnlyCompileOptions& rhs);
ReadOnlyCompileOptions(const ReadOnlyCompileOptions&) = delete;
ReadOnlyCompileOptions& operator=(const ReadOnlyCompileOptions&) = delete;
public:
#if defined(DEBUG) || defined(JS_JITSPEW)
template <typename Printer>
void dumpWith(Printer& print) const {
this->TransitiveCompileOptions::dumpWith(print);
# define PrintFields_(Name) print(#Name, Name)
PrintFields_(lineno);
print("column", column.oneOriginValue());
PrintFields_(scriptSourceOffset);
PrintFields_(isRunOnce);
PrintFields_(noScriptRval);
# undef PrintFields_
}
#endif // defined(DEBUG) || defined(JS_JITSPEW)
};
class JS_PUBLIC_API OwningDecodeOptions;
/**
* Compilation options, with dynamic lifetime. An instance of this type
* makes a copy of / holds / roots all dynamically allocated resources
* (principals; elements; strings) that it refers to. Its destructor frees
* / drops / unroots them. This is heavier than CompileOptions, below, but
* unlike CompileOptions, it can outlive any given stack frame.
*
* Note that this *roots* any JS values it refers to - they're live
* unconditionally. Thus, instances of this type can't be owned, directly
* or indirectly, by a JavaScript object: if any value that this roots ever
* comes to refer to the object that owns this, then the whole cycle, and
* anything else it entrains, will never be freed.
*/
class JS_PUBLIC_API OwningCompileOptions final : public ReadOnlyCompileOptions {
public:
// A minimal constructor, for use with OwningCompileOptions::copy.
explicit OwningCompileOptions(JSContext* cx);
struct ForFrontendContext {};
explicit OwningCompileOptions(const ForFrontendContext&)
: ReadOnlyCompileOptions() {}
~OwningCompileOptions();
private:
template <typename ContextT>
bool copyImpl(ContextT* cx, const ReadOnlyCompileOptions& rhs);
public:
/** Set this to a copy of |rhs|. Return false on OOM. */
bool copy(JSContext* cx, const ReadOnlyCompileOptions& rhs);
bool copy(JS::FrontendContext* fc, const ReadOnlyCompileOptions& rhs);
void steal(OwningCompileOptions&& rhs);
void steal(OwningDecodeOptions&& rhs);
size_t sizeOfExcludingThis(mozilla::MallocSizeOf mallocSizeOf) const;
OwningCompileOptions& setIsRunOnce(bool once) {
isRunOnce = once;
return *this;
}
OwningCompileOptions& setForceStrictMode() {
forceStrictMode_ = true;
return *this;
}
OwningCompileOptions& setModule() {
// ES6 10.2.1 Module code is always strict mode code.
setForceStrictMode();
setIsRunOnce(true);
allowHTMLComments = false;
return *this;
}
private:
void release();
OwningCompileOptions(const OwningCompileOptions&) = delete;
OwningCompileOptions& operator=(const OwningCompileOptions&) = delete;
};
/**
* Compilation options stored on the stack. An instance of this type
* simply holds references to dynamically allocated resources (element;
* filename; source map URL) that are owned by something else. If you
* create an instance of this type, it's up to you to guarantee that
* everything you store in it will outlive it.
*/
class MOZ_STACK_CLASS JS_PUBLIC_API CompileOptions final
: public ReadOnlyCompileOptions {
public:
// Default options determined using the JSContext.
explicit CompileOptions(JSContext* cx);
// Copy both the transitive and the non-transitive options from another
// options object.
CompileOptions(JSContext* cx, const ReadOnlyCompileOptions& rhs)
: ReadOnlyCompileOptions() {
copyPODNonTransitiveOptions(rhs);
copyPODTransitiveOptions(rhs);
filename_ = rhs.filename();
introducerFilename_ = rhs.introducerFilename();
sourceMapURL_ = rhs.sourceMapURL();
}
// Construct a CompileOption in the context where JSContext is not available.
// prefableOptions should reflect the compilation-specific user prefs.
explicit CompileOptions(const PrefableCompileOptions& prefableOptions)
: ReadOnlyCompileOptions() {
prefableOptions_ = prefableOptions;
}
CompileOptions& setFile(const char* f) {
filename_ = JS::ConstUTF8CharsZ(f);
return *this;
}
CompileOptions& setLine(uint32_t l) {
lineno = l;
return *this;
}
CompileOptions& setFileAndLine(const char* f, uint32_t l) {
filename_ = JS::ConstUTF8CharsZ(f);
lineno = l;
return *this;
}
CompileOptions& setSourceMapURL(const char16_t* s) {
sourceMapURL_ = s;
return *this;
}
CompileOptions& setMutedErrors(bool mute) {
mutedErrors_ = mute;
return *this;
}
CompileOptions& setColumn(JS::ColumnNumberOneOrigin c) {
column = c;
return *this;
}
CompileOptions& setScriptSourceOffset(unsigned o) {
scriptSourceOffset = o;
return *this;
}
CompileOptions& setIsRunOnce(bool once) {
isRunOnce = once;
return *this;
}
CompileOptions& setNoScriptRval(bool nsr) {
noScriptRval = nsr;
return *this;
}
CompileOptions& setSkipFilenameValidation(bool b) {
skipFilenameValidation_ = b;
return *this;
}
CompileOptions& setSelfHostingMode(bool shm) {
selfHostingMode = shm;
return *this;
}
CompileOptions& setSourceIsLazy(bool l) {
sourceIsLazy = l;
return *this;
}
CompileOptions& setNonSyntacticScope(bool n) {
nonSyntacticScope = n;
return *this;
}
CompileOptions& setIntroductionType(const char* t) {
introductionType = t;
return *this;
}
CompileOptions& setDeferDebugMetadata(bool v = true) {
deferDebugMetadata_ = v;
return *this;
}
CompileOptions& setHideScriptFromDebugger(bool v = true) {
hideScriptFromDebugger_ = v;
return *this;
}
CompileOptions& setIntroductionInfo(const char* introducerFn,
const char* intro, uint32_t line,
uint32_t offset) {
introducerFilename_ = JS::ConstUTF8CharsZ(introducerFn);
introductionType = intro;
introductionLineno = line;
introductionOffset = offset;
hasIntroductionInfo = true;
return *this;
}
// Set introduction information according to any currently executing script.
CompileOptions& setIntroductionInfoToCaller(
JSContext* cx, const char* introductionType,
JS::MutableHandle<JSScript*> introductionScript);
CompileOptions& setDiscardSource() {
discardSource = true;
return *this;
}
CompileOptions& setForceFullParse() {
eagerDelazificationStrategy_ = DelazificationOption::ParseEverythingEagerly;
return *this;
}
void warnAboutConflictingDelazification() const;
CompileOptions& setEagerDelazificationStrategy(
DelazificationOption strategy) {
const auto PEE = DelazificationOption::ParseEverythingEagerly;
if (eagerDelazificationStrategy_ == PEE && strategy != PEE) {
// Parse Everything Eagerly cannot be replaced, do noting.
warnAboutConflictingDelazification();
return *this;
}
eagerDelazificationStrategy_ = strategy;
return *this;
}
CompileOptions& setForceStrictMode() {
forceStrictMode_ = true;
return *this;
}
CompileOptions& setModule() {
// ES6 10.2.1 Module code is always strict mode code.
setForceStrictMode();
setIsRunOnce(true);
allowHTMLComments = false;
return *this;
}
CompileOptions(const CompileOptions& rhs) = delete;
CompileOptions& operator=(const CompileOptions& rhs) = delete;
};
/**
* Subset of CompileOptions fields used while instantiating Stencils.
*/
class JS_PUBLIC_API InstantiateOptions {
public:
bool skipFilenameValidation = false;
bool hideScriptFromDebugger = false;
bool deferDebugMetadata = false;
DelazificationOption eagerDelazificationStrategy_ =
DelazificationOption::OnDemandOnly;
InstantiateOptions() = default;
explicit InstantiateOptions(const ReadOnlyCompileOptions& options)
: skipFilenameValidation(options.skipFilenameValidation_),
hideScriptFromDebugger(options.hideScriptFromDebugger_),
deferDebugMetadata(options.deferDebugMetadata_),
eagerDelazificationStrategy_(options.eagerDelazificationStrategy()) {}
void copyTo(CompileOptions& options) const {
options.skipFilenameValidation_ = skipFilenameValidation;
options.hideScriptFromDebugger_ = hideScriptFromDebugger;
options.deferDebugMetadata_ = deferDebugMetadata;
options.setEagerDelazificationStrategy(eagerDelazificationStrategy_);
}
bool hideFromNewScriptInitial() const {
return deferDebugMetadata || hideScriptFromDebugger;
}
#ifdef DEBUG
// Assert that all fields have default value.
//
// This can be used when instantiation is performed as separate step than
// compile-to-stencil, and CompileOptions isn't available there.
void assertDefault() const {
MOZ_ASSERT(skipFilenameValidation == false);
MOZ_ASSERT(hideScriptFromDebugger == false);
MOZ_ASSERT(deferDebugMetadata == false);
MOZ_ASSERT(eagerDelazificationStrategy_ ==
DelazificationOption::OnDemandOnly);
}
// Assert that all fields have values compatible with the default value.
//
// This can be used in the same way as assertDefault, in case the
// setForceFullParse() is used on the original compile options.
void assertCompatibleWithDefault() const {
MOZ_ASSERT(skipFilenameValidation == false);
MOZ_ASSERT(hideScriptFromDebugger == false);
MOZ_ASSERT(deferDebugMetadata == false);
// The instantiation step uses the eagerDelazificationStrategy_ field
// only for TransitiveCompileOptions::populateDelazificationCache().
//
// Both the default OnDemandOnly and
// the ParseEverythingEagerly from setForceFullParse() returns
// false, and they're are compatible.
MOZ_ASSERT(eagerDelazificationStrategy_ ==
DelazificationOption::OnDemandOnly ||
eagerDelazificationStrategy_ ==
DelazificationOption::ParseEverythingEagerly);
}
#endif
};
/**
* Subset of CompileOptions fields used while decoding Stencils.
*/
class JS_PUBLIC_API ReadOnlyDecodeOptions {
public:
bool borrowBuffer = false;
bool usePinnedBytecode = false;
protected:
JS::ConstUTF8CharsZ introducerFilename_;
public:
// See `TransitiveCompileOptions::introductionType` field for details.
const char* introductionType = nullptr;
uint32_t introductionLineno = 0;
uint32_t introductionOffset = 0;
protected:
ReadOnlyDecodeOptions() = default;
ReadOnlyDecodeOptions(const ReadOnlyDecodeOptions&) = delete;
ReadOnlyDecodeOptions& operator=(const ReadOnlyDecodeOptions&) = delete;
template <typename T>
void copyPODOptionsFrom(const T& options) {
borrowBuffer = options.borrowBuffer;
usePinnedBytecode = options.usePinnedBytecode;
introductionType = options.introductionType;
introductionLineno = options.introductionLineno;
introductionOffset = options.introductionOffset;
}
template <typename T>
void copyPODOptionsTo(T& options) const {
options.borrowBuffer = borrowBuffer;
options.usePinnedBytecode = usePinnedBytecode;
options.introductionType = introductionType;
options.introductionLineno = introductionLineno;
options.introductionOffset = introductionOffset;
}
public:
void copyTo(CompileOptions& options) const {
copyPODOptionsTo(options);
options.introducerFilename_ = introducerFilename_;
}
JS::ConstUTF8CharsZ introducerFilename() const { return introducerFilename_; }
};
class MOZ_STACK_CLASS JS_PUBLIC_API DecodeOptions final
: public ReadOnlyDecodeOptions {
public:
DecodeOptions() = default;
explicit DecodeOptions(const ReadOnlyCompileOptions& options) {
copyPODOptionsFrom(options);
introducerFilename_ = options.introducerFilename();
}
};
class JS_PUBLIC_API OwningDecodeOptions final : public ReadOnlyDecodeOptions {
friend class OwningCompileOptions;
public:
OwningDecodeOptions() = default;
~OwningDecodeOptions();
bool copy(JS::FrontendContext* maybeFc, const ReadOnlyDecodeOptions& rhs);
void infallibleCopy(const ReadOnlyDecodeOptions& rhs);
size_t sizeOfExcludingThis(mozilla::MallocSizeOf mallocSizeOf) const;
private:
void release();
OwningDecodeOptions(const OwningDecodeOptions&) = delete;
OwningDecodeOptions& operator=(const OwningDecodeOptions&) = delete;
};
} // namespace JS
#endif /* js_CompileOptions_h */