blob: 2477e625fe5b614a468dcd740a1be9360b94b5f2 [file] [log] [blame]
/*
* Copyright (C) 2015 Yusuke Suzuki <utatane.tea@gmail.com>.
* Copyright (C) 2016-2019 Apple Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
* OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
// @internal
@globalPrivate
function newPromiseReaction(promiseOrCapability, onFulfilled, onRejected)
{
"use strict";
return {
@promiseOrCapability: promiseOrCapability,
@onFulfilled: onFulfilled,
@onRejected: onRejected,
@next: @undefined,
};
}
@globalPrivate
function newPromiseCapabilitySlow(constructor)
{
var promiseCapability = {
@resolve: @undefined,
@reject: @undefined,
@promise: @undefined,
};
if (!@isConstructor(constructor))
@throwTypeError("promise capability requires a constructor function");
function @executor(resolve, reject)
{
if (promiseCapability.@resolve !== @undefined)
@throwTypeError("resolve function is already set");
if (promiseCapability.@reject !== @undefined)
@throwTypeError("reject function is already set");
promiseCapability.@resolve = resolve;
promiseCapability.@reject = reject;
}
var promise = new constructor(@executor);
if (typeof promiseCapability.@resolve !== "function")
@throwTypeError("executor did not take a resolve function");
if (typeof promiseCapability.@reject !== "function")
@throwTypeError("executor did not take a reject function");
promiseCapability.@promise = promise;
return promiseCapability;
}
@globalPrivate
function newPromiseCapability(constructor)
{
"use strict";
if (constructor === @Promise) {
var promise = @newPromise();
var resolvingFunctions = @createResolvingFunctions(promise);
@putByIdDirectPrivate(resolvingFunctions, "promise", promise);
return resolvingFunctions;
}
return @newPromiseCapabilitySlow(constructor);
}
@globalPrivate
function newHandledRejectedPromise(error)
{
"use strict";
var promise = @newPromise();
@rejectPromiseWithFirstResolvingFunctionCallCheck(promise, error);
@putPromiseInternalField(promise, @promiseFieldFlags, @getPromiseInternalField(promise, @promiseFieldFlags) | @promiseFlagsIsHandled);
return promise;
}
@globalPrivate
function triggerPromiseReactions(state, reactions, argument)
{
"use strict";
// Reverse the order of singly-linked-list.
var previous = @undefined;
var current = reactions;
while (current) {
var next = current.@next;
current.@next = previous;
previous = current;
current = next;
}
reactions = previous;
current = reactions;
while (current) {
@enqueueJob(@promiseReactionJob, state, current, argument);
current = current.@next;
}
}
@globalPrivate
function resolvePromise(promise, resolution)
{
"use strict";
@assert(@isPromise(promise));
if (resolution === promise)
return @rejectPromise(promise, @makeTypeError("Cannot resolve a promise with itself"));
if (!@isObject(resolution))
return @fulfillPromise(promise, resolution);
var then;
try {
then = resolution.then;
} catch (error) {
return @rejectPromise(promise, error);
}
if (@isPromise(resolution) && then === @defaultPromiseThen) {
@enqueueJob(@promiseResolveThenableJobFast, resolution, promise);
return;
}
if (typeof then !== 'function')
return @fulfillPromise(promise, resolution);
@enqueueJob(@promiseResolveThenableJob, resolution, then, @createResolvingFunctions(promise));
}
@globalPrivate
function rejectPromise(promise, reason)
{
"use strict";
@assert(@isPromise(promise));
@assert((@getPromiseInternalField(promise, @promiseFieldFlags) & @promiseStateMask) == @promiseStatePending);
var flags = @getPromiseInternalField(promise, @promiseFieldFlags);
var reactions = @getPromiseInternalField(promise, @promiseFieldReactionsOrResult);
@putPromiseInternalField(promise, @promiseFieldReactionsOrResult, reason);
@putPromiseInternalField(promise, @promiseFieldFlags, flags | @promiseStateRejected);
@InspectorInstrumentation.promiseRejected(promise, reason, reactions);
if (!(flags & @promiseFlagsIsHandled))
@hostPromiseRejectionTracker(promise, @promiseRejectionReject);
@triggerPromiseReactions(@promiseStateRejected, reactions, reason);
}
@globalPrivate
function fulfillPromise(promise, value)
{
"use strict";
@assert(@isPromise(promise));
@assert((@getPromiseInternalField(promise, @promiseFieldFlags) & @promiseStateMask) == @promiseStatePending);
var flags = @getPromiseInternalField(promise, @promiseFieldFlags);
var reactions = @getPromiseInternalField(promise, @promiseFieldReactionsOrResult);
@putPromiseInternalField(promise, @promiseFieldReactionsOrResult, value);
@putPromiseInternalField(promise, @promiseFieldFlags, flags | @promiseStateFulfilled);
@InspectorInstrumentation.promiseFulfilled(promise, value, reactions);
@triggerPromiseReactions(@promiseStateFulfilled, reactions, value);
}
@globalPrivate
function resolvePromiseWithFirstResolvingFunctionCallCheck(promise, value)
{
@assert(@isPromise(promise));
var flags = @getPromiseInternalField(promise, @promiseFieldFlags);
if (flags & @promiseFlagsIsFirstResolvingFunctionCalled)
return;
@putPromiseInternalField(promise, @promiseFieldFlags, flags | @promiseFlagsIsFirstResolvingFunctionCalled);
return @resolvePromise(promise, value);
}
@globalPrivate
function rejectPromiseWithFirstResolvingFunctionCallCheck(promise, reason)
{
@assert(@isPromise(promise));
var flags = @getPromiseInternalField(promise, @promiseFieldFlags);
if (flags & @promiseFlagsIsFirstResolvingFunctionCalled)
return;
@putPromiseInternalField(promise, @promiseFieldFlags, flags | @promiseFlagsIsFirstResolvingFunctionCalled);
return @rejectPromise(promise, reason);
}
@globalPrivate
function createResolvingFunctions(promise)
{
"use strict";
@assert(@isPromise(promise));
var alreadyResolved = false;
function @resolve(resolution) {
if (alreadyResolved)
return @undefined;
alreadyResolved = true;
return @resolvePromise(promise, resolution);
}
function @reject(reason) {
if (alreadyResolved)
return @undefined;
alreadyResolved = true;
return @rejectPromise(promise, reason);
}
return { @resolve, @reject };
}
@globalPrivate
function promiseReactionJobWithoutPromise(handler, argument)
{
"use strict";
try {
handler(argument);
} catch {
// This is user-uncatchable promise. We just ignore the error here.
}
}
// This function has strong guarantee that each handler function (onFulfilled and onRejected) will be called at most once.
@globalPrivate
function resolveWithoutPromise(resolution, onFulfilled, onRejected)
{
"use strict";
if (!@isObject(resolution)) {
@fulfillWithoutPromise(resolution, onFulfilled, onRejected);
return;
}
var then;
try {
then = resolution.then;
} catch (error) {
@rejectWithoutPromise(error, onFulfilled, onRejected);
return;
}
if (@isPromise(resolution) && then === @defaultPromiseThen) {
@enqueueJob(@promiseResolveThenableJobWithoutPromiseFast, resolution, onFulfilled, onRejected);
return;
}
if (typeof then !== 'function') {
@fulfillWithoutPromise(resolution, onFulfilled, onRejected);
return;
}
// Wrap onFulfilled and onRejected with @createResolvingFunctionsWithoutPromise to ensure that each function will be called at most once.
@enqueueJob(@promiseResolveThenableJob, resolution, then, @createResolvingFunctionsWithoutPromise(onFulfilled, onRejected));
}
// This function has strong guarantee that each handler function (onFulfilled and onRejected) will be called at most once.
@globalPrivate
function rejectWithoutPromise(reason, onFulfilled, onRejected)
{
"use strict";
@enqueueJob(@promiseReactionJobWithoutPromise, onRejected, reason);
}
// This function has strong guarantee that each handler function (onFulfilled and onRejected) will be called at most once.
@globalPrivate
function fulfillWithoutPromise(value, onFulfilled, onRejected)
{
"use strict";
@enqueueJob(@promiseReactionJobWithoutPromise, onFulfilled, value);
}
@globalPrivate
function createResolvingFunctionsWithoutPromise(onFulfilled, onRejected)
{
"use strict";
var alreadyResolved = false;
function @resolve(resolution) {
if (alreadyResolved)
return @undefined;
alreadyResolved = true;
@resolveWithoutPromise(resolution, onFulfilled, onRejected);
}
function @reject(reason) {
if (alreadyResolved)
return @undefined;
alreadyResolved = true;
@rejectWithoutPromise(reason, onFulfilled, onRejected);
}
return { @resolve, @reject };
}
@globalPrivate
function promiseReactionJob(state, reaction, argument)
{
// Promise Reaction has four types.
// 1. @promiseOrCapability is PromiseCapability, and having handlers.
// The most generic one.
// 2. @promiseOrCapability is Promise, and having handlers.
// We just have promise.
// 3. @promiseOrCapability is Promise, and not having handlers.
// It only has promise. Just resolving it with the value.
// 4. Only having @onFulfilled and @onRejected
// It does not have promise capability. Just handlers are passed.
"use strict";
var promiseOrCapability = reaction.@promiseOrCapability;
// Case (3).
if (!reaction.@onRejected) {
@assert(!reaction.@onFulfilled);
try {
@assert(@isPromise(promiseOrCapability));
if (state === @promiseStateFulfilled)
@resolvePromise(promiseOrCapability, argument);
else
@rejectPromise(promiseOrCapability, argument);
} catch {
// This is user-uncatchable promise. We just ignore the error here.
}
return;
}
var handler = (state === @promiseStateFulfilled) ? reaction.@onFulfilled: reaction.@onRejected;
// Case (4).
if (!promiseOrCapability) {
@promiseReactionJobWithoutPromise(handler, argument);
return;
}
// Case (1), or (2).
var result;
try {
result = handler(argument);
} catch (error) {
if (@isPromise(promiseOrCapability)) {
@rejectPromise(promiseOrCapability, error);
return;
}
promiseOrCapability.@reject.@call(@undefined, error);
return;
}
if (@isPromise(promiseOrCapability)) {
@resolvePromise(promiseOrCapability, result);
return;
}
promiseOrCapability.@resolve.@call(@undefined, result);
}
@globalPrivate
function promiseResolveThenableJobFast(thenable, promiseToResolve)
{
"use strict";
@assert(@isPromise(thenable));
@assert(@isPromise(promiseToResolve));
var flags = @getPromiseInternalField(thenable, @promiseFieldFlags);
var state = flags & @promiseStateMask;
var reaction = @newPromiseReaction(promiseToResolve, @undefined, @undefined);
if (state === @promiseStatePending) {
reaction.@next = @getPromiseInternalField(thenable, @promiseFieldReactionsOrResult);
@putPromiseInternalField(thenable, @promiseFieldReactionsOrResult, reaction);
} else {
if (state === @promiseStateRejected && !(flags & @promiseFlagsIsHandled))
@hostPromiseRejectionTracker(thenable, @promiseRejectionHandle);
@enqueueJob(@promiseReactionJob, state, reaction, @getPromiseInternalField(thenable, @promiseFieldReactionsOrResult));
}
@putPromiseInternalField(thenable, @promiseFieldFlags, @getPromiseInternalField(thenable, @promiseFieldFlags) | @promiseFlagsIsHandled);
}
@globalPrivate
function promiseResolveThenableJobWithoutPromiseFast(thenable, onFulfilled, onRejected)
{
"use strict";
@assert(@isPromise(thenable));
var flags = @getPromiseInternalField(thenable, @promiseFieldFlags);
var state = flags & @promiseStateMask;
if (state === @promiseStatePending) {
var reaction = @newPromiseReaction(@undefined, onFulfilled, onRejected);
reaction.@next = @getPromiseInternalField(thenable, @promiseFieldReactionsOrResult);
@putPromiseInternalField(thenable, @promiseFieldReactionsOrResult, reaction);
} else {
var result = @getPromiseInternalField(thenable, @promiseFieldReactionsOrResult);
if (state === @promiseStateRejected) {
if (!(flags & @promiseFlagsIsHandled))
@hostPromiseRejectionTracker(thenable, @promiseRejectionHandle);
@rejectWithoutPromise(result, onFulfilled, onRejected);
} else
@fulfillWithoutPromise(result, onFulfilled, onRejected);
}
@putPromiseInternalField(thenable, @promiseFieldFlags, @getPromiseInternalField(thenable, @promiseFieldFlags) | @promiseFlagsIsHandled);
}
@globalPrivate
function promiseResolveThenableJob(thenable, then, resolvingFunctions)
{
"use strict";
try {
return then.@call(thenable, resolvingFunctions.@resolve, resolvingFunctions.@reject);
} catch (error) {
return resolvingFunctions.@reject.@call(@undefined, error);
}
}