IJsAdapter<TValue> Interface

Gets the realm of the running execution context.

Gets the null value.

Gets the undefined value.

Returns the value of a boolean.

Returns the time value of a Date object (milliseconds since the Unix epoch, or NaN).

Returns the value of a number.

Returns the value of a string.

[[Call]] (https://tc39.es/ecma262/#sec-call).

[[Construct]] (https://tc39.es/ecma262/#sec-construct).

Creates an array in the current realm.

Creates an ArrayBuffer containing a copy of bytes in the current realm. The default implementation constructs it with the ArrayBuffer and Uint8Array constructors of the global object.

Creates a typed array or a DataView (kind) of length elements viewing buffer from byteOffset, in the current realm. The default implementation calls the constructor of the global object.

Creates an ArrayBuffer in the current realm whose data block is data (the bytes are shared, not copied), and whose [[ArrayBufferDetachKey]] is detachKey: it cannot be transferred or detached by scripts (e.g. the buffer of a WebAssembly.Memory). Returns null when the engine does not support it. The default implementation returns null.

Creates a built-in function object that is a constructor in the current realm (e.g. an interface object, https://webidl.spec.whatwg.org/#interface-object): its name and length properties are set, it has no prototype property, and Function.prototype.toString returns its NativeFunction representation (function name() { [native code] }). [[Call]] and [[Construct]] call constructor; NewTarget is undefined for [[Call]]. The default implementation returns a Proxy of a script function.

Creates the JavaScript object of a cross-origin platform object (a Location object, https://html.spec.whatwg.org/multipage/nav-history-apis.html#the-location-interface) in the current realm: its prototype cannot be changed, it cannot be made non-extensible, and its internal methods are the cross-origin ones of handler when the current realm is not same origin-domain with the object. Returns null when the engine does not support it (the object is then created by IJsAdapter<TValue>.CreatePlatformObject, and only its members check the origin of their caller). The default implementation returns null.

Creates a Date object in the current realm.

Returns the .NET exception that throws value in the engine.

Creates a built-in function object in the current realm (https://tc39.es/ecma262/#sec-createbuiltinfunction): its name and length properties are set, it is not a constructor, and it has no prototype property.

Creates the JavaScript object of a .NET platform object in the current realm, as IJsAdapter<TValue>.CreatePlatformObject with a handler, that also has a [[Call]] internal method (call) and an [[IsHTMLDDA]] internal slot (https://tc39.es/ecma262/#sec-IsHTMLDDA-internal-slot): document.all, whose typeof is "undefined", that is falsy and loosely equal to null and undefined. The default implementation returns a Proxy of a function whose target is a platform object: it is not an [[IsHTMLDDA]] object, and IJsAdapter<TValue>.TryGetPlatformObject does not return its .NET object.

Creates an ordinary object in the current realm, whose prototype is prototype (an object or null).

Creates the JavaScript object of a .NET platform object in the current realm. When handler is not null, the object is a host exotic object whose internal methods call the handler first (the legacy platform objects).

Creates a SharedArrayBuffer in the current realm whose data block is a data block returned by IJsAdapter<TValue>.GetSharedDataBlock (of any engine instance of the adapter), so that the buffers share their memory. Returns null when it is not supported (the bindings then use IJsAdapter<TValue>.SetSharedDataBlock). The default implementation returns null.

Creates a WindowProxy exotic object (https://html.spec.whatwg.org/multipage/nav-history-apis.html#the-windowproxy-exotic-object) whose internal methods are implemented with handler. It belongs to no realm. Returns null when the engine does not support it: a window is then exposed by its global object. The default implementation returns null.

[[DefineOwnProperty]] (https://tc39.es/ecma262/#sec-definepropertyorthrow). Returns false on failure.

[[Delete]].

Detaches an ArrayBuffer created by IJsAdapter<TValue>.CreateArrayBufferWithData (DetachArrayBuffer with its detach key).

Evaluates code in a realm, as an indirect eval (https://tc39.es/ecma262/#sec-performeval). It does not run the jobs.

Evaluates a script of the implementation (a constant source text, e.g. Fetch.js) in a realm, as IJsAdapter<TValue>.Evaluate: the adapter may parse it once for all the realms. It does not run the jobs. The default implementation calls IJsAdapter<TValue>.Evaluate.

Creates a BigInt value.

Creates a boolean value.

Creates a number value.

Creates a string value.

[[Get]] (https://tc39.es/ecma262/#sec-get-o-p). key is a string or a symbol.

Returns %AbstractModuleSource% of the current realm (https://tc39.es/proposal-source-phase-imports/#sec-abstractmodulesource-objects), which the interface object of WebAssembly.Module extends (https://webassembly.github.io/esm-integration/js-api/index.html#webassembly-module-objects), or null when the engine does not implement the source phase imports: the interface then extends nothing. The default implementation returns null.

Returns the information of an error value: its message, file name, line and column.

Gets the global object of a realm.

[[GetOwnProperty]]. Returns false when the property does not exist.

Gets the number of own properties of an object, without running code: the bindings remember the sizes of the objects they create, and call IJsAdapter<TValue>.ReserveProperties with them in the next realms. The default implementation returns 0 (unknown).

[[GetPrototypeOf]].

Returns the shared data block of a SharedArrayBuffer ([[ArrayBufferData]]), an opaque object that IJsAdapter<TValue>.SetSharedDataBlock can give to another SharedArrayBuffer of any engine instance of the adapter (possibly on another thread), so that they share their memory (the structured serialization of the SharedArrayBuffer objects). Returns null for other values, or when the engine cannot share the memory of its buffers. The default implementation returns null.

Returns a well-known symbol (https://tc39.es/ecma262/#sec-well-known-symbols).

Returns whether a value is an object that has an internal slot, or null when the adapter cannot tell: the structured serialization then calls the intrinsic function that reads the slot, which throws when the slot is missing (a thrown exception is slow, and most objects are ordinary objects). The default implementation returns null.

[[HasProperty]].

Gets whether the value is an Array exotic object (https://tc39.es/ecma262/#sec-array-exotic-objects), not a Proxy of an array.

Gets whether the value is a BigInt.

Gets whether the value is a boolean.

Gets whether the value is callable (https://tc39.es/ecma262/#sec-iscallable).

Gets whether the value is a constructor (https://tc39.es/ecma262/#sec-isconstructor).

Returns whether realm is the realm of the running execution context.

Gets whether the value is a Date object.

Gets whether the value is null.

Gets whether the value is a number.

Gets whether the value is an object (including functions).

Gets whether a buffer source is backed by a resizable ArrayBuffer or a growable SharedArrayBuffer (the buffer itself, or the buffer that a view views), which the buffer source types reject unless they have the [AllowResizable] extended attribute (https://webidl.spec.whatwg.org/#AllowResizable). The default implementation returns false: the resizable buffers are accepted.

Whether the value is a revoked proxy (its [[GetPrototypeOf]] throws). objectPrototype is the %Object.prototype% of the realm in which the proxy was created, or null when the engine does not track it.

Gets whether the value is a string.

Gets whether the value is a symbol.

Returns whether an exception aborts the running script (e.g. the termination of a worker): it is not a JavaScript exception, and is not converted by the DOM. The default implementation returns false.

Gets whether the value is undefined.

Returns whether a .NET object is a value of the engine, and not another .NET object given to the bindings (e.g. a platform object or a list, which the bindings convert). The default implementation tests whether it is a TValue: an adapter whose values have no specific type (e.g. TValue is Object) overrides it.

OrdinaryDefineOwnProperty (https://tc39.es/ecma262/#sec-ordinarydefineownproperty) of a host exotic object.

OrdinaryDelete (https://tc39.es/ecma262/#sec-ordinarydelete) of a host exotic object.

Performs an ordinary internal method of a host exotic object, bypassing its IJsHostObjectHandler<TValue> (e.g. OrdinaryGetOwnProperty, https://tc39.es/ecma262/#sec-ordinarygetownproperty).

OrdinaryOwnPropertyKeys (https://tc39.es/ecma262/#sec-ordinaryownpropertykeys) of a host exotic object.

[[OwnPropertyKeys]]: the strings and symbols.

Prepares an object for count more properties (e.g. the interface objects of a global object), so that an engine can allocate their storage once. It does not change the behavior of the object. The default implementation does nothing.

Runs action with realm as the current realm.

[[Set]] (https://tc39.es/ecma262/#sec-set-o-p-v-throw), throwing a TypeError on failure.

Sets the [[ModuleSourceClassName]] internal slot of a platform object created by IJsAdapter<TValue>.CreatePlatformObject (e.g. WebAssembly.Module), read by the %AbstractModuleSource%.prototype[@@toStringTag] getter. The default implementation does nothing.

[[SetPrototypeOf]].

Replaces the data block of a new SharedArrayBuffer of the same byte length by a data block returned by IJsAdapter<TValue>.GetSharedDataBlock. Returns false when it is not supported. The default implementation returns false.

https://tc39.es/ecma262/#sec-tobigint

https://tc39.es/ecma262/#sec-toboolean

https://tc39.es/ecma262/#sec-tonumber

https://tc39.es/ecma262/#sec-tostring (throws a TypeError for a symbol).

Gets the kind and the bytes of an ArrayBuffer, a SharedArrayBuffer, a typed array or a DataView (the objects with an [[ArrayBufferData]], [[TypedArrayName]] or [[DataView]] internal slot), without running JavaScript code. bytes is a view of the data block of the buffer, so that the writes are visible to JavaScript; it is empty when the buffer is detached. isShared is true when the buffer (or the viewed buffer) is a SharedArrayBuffer. Returns false for other values. The default implementation returns false: the buffer source types cannot be converted.

Returns the .NET object of a JavaScript platform object created by IJsAdapter<TValue>.CreatePlatformObject.

Returns the JavaScript value thrown by an exception of the engine, or false for another exception.

Gives a platform object created by IJsAdapter<TValue>.CreatePlatformObject an [[ErrorData]] internal slot: a DOMException (https://webidl.spec.whatwg.org/#es-DOMException-specialness), for which Error.isError returns true. The engine also sets its stack trace to the one of the running code, whose first line is stackHeader, read by the Error.prototype.stack accessor (https://tc39.es/proposal-error-stack-accessor/). Returns false when the engine does not support it: the object then gets an own stack data property. The default implementation returns false.

Makes an object an immutable prototype exotic object (https://tc39.es/ecma262/#sec-immutable-prototype-exotic-objects), if the engine supports it: its [[SetPrototypeOf]] only accepts its current prototype. A proxy is left unchanged (its handler defines its [[SetPrototypeOf]]). Returns false when the engine does not support it: the bindings then replace the built-in functions that change prototypes (see WebIdlRealm<TAdapter, TValue>). The default implementation returns false.

Sets the [[Stack]] internal slot of an error (https://tc39.es/proposal-error-stack-accessor/), read by the Error.prototype.stack accessor: the stack of a deserialized error (https://html.spec.whatwg.org/multipage/structured-data.html#structureddeserialize). Returns false when the engine has no such slot (the stack is then an own data property of the error). The default implementation returns false.

Sets the this value of the global code of a realm (its [[GlobalThisValue]], also the value of globalThis): the WindowProxy of a window. Returns false when the engine does not support it (the this value is then the global object). The default implementation returns false.