import { HostHasSourceTextAvailable, } from '../host-defined/engine.mts'; import { JSStringValue, ObjectValue, UndefinedValue, Value, wellKnownSymbols, type Arguments, type FunctionCallContext, } from '../value.mts'; import { Q, X, type ValueCompletion, type ValueEvaluator, } from '../completion.mts'; import { __ts_cast__, type Mutable } from '../utils/language.mts'; import { assignProps } from './bootstrap.mts'; import { Assert, Call, Construct, CreateListFromArrayLike, IsCallable, IsConstructor, OrdinaryHasInstance, PrepareForTailCall, SameValue, CreateBuiltinFunction, MakeBasicObject, type ExoticObject, type FunctionObject, isBuiltinFunctionObject, hasSourceTextInternalSlot, CopyNameAndLength, Realm, Throw, type BaseFunctionObject, } from '#self'; export interface BoundFunctionObject extends ExoticObject, BaseFunctionObject { readonly BoundTargetFunction: FunctionObject; readonly BoundThis: Value; readonly BoundArguments: Arguments; } export function isBoundFunctionObject(object: object): object is BoundFunctionObject { return 'BoundTargetFunction' in object; } /** https://tc39.es/ecma262/#sec-properties-of-the-function-prototype-object */ function FunctionProto() { // * accepts any arguments and returns undefined when invoked. return Value.undefined; } /** https://tc39.es/ecma262/#sec-function.prototype.apply */ function* FunctionProto_apply([thisArg = Value.undefined, argArray = Value.undefined]: Arguments, { thisValue }: FunctionCallContext): ValueEvaluator { // 1. Let func be the this value. const func = thisValue; // 2. If IsCallable(func) is false, throw a TypeError exception. if (!IsCallable(func)) { return Throw.TypeError("Expected 'this' value to be a function but got $1", func); } // 3. If argArray is undefined or null, then if (argArray === Value.undefined || argArray === Value.null) { // a. Perform PrepareForTailCall(). PrepareForTailCall(); // b. Return ? Call(func, thisArg). return Q(yield* Call(func, thisArg)); } // 4. Let argList be ? CreateListFromArrayLike(argArray). const argList = Q(yield* CreateListFromArrayLike(argArray)); // 5. Perform PrepareForTailCall(). PrepareForTailCall(); // 6. Return ? Call(func, thisArg, argList). return Q(yield* Call(func, thisArg, argList)); } function* BoundFunctionExoticObjectCall(this: BoundFunctionObject, _thisArgument: ObjectValue, argumentsList: Arguments): ValueEvaluator { const F = this; const target = F.BoundTargetFunction; const boundThis = F.BoundThis; const boundArgs = F.BoundArguments; const args = [...boundArgs.values(), ...argumentsList.values()]; return Q(yield* Call(target, boundThis, args)); } function* BoundFunctionExoticObjectConstruct(this: BoundFunctionObject, argumentsList: Arguments, newTarget: FunctionObject | UndefinedValue): ValueEvaluator { const F = this; const target = F.BoundTargetFunction; Assert(IsConstructor(target)); const boundArgs = F.BoundArguments; const args = [...boundArgs.values(), ...argumentsList.values()]; if (SameValue(F, newTarget)) { newTarget = target; } return Q(yield* Construct(target, args, newTarget)); } /** https://tc39.es/ecma262/#sec-boundfunctioncreate */ function* BoundFunctionCreate(targetFunction: ObjectValue, boundThis: Value, boundArgs: Arguments): ValueEvaluator { // 1. Assert: Type(targetFunction) is Object. Assert(targetFunction instanceof ObjectValue); // 2. Let proto be ? targetFunction.[[GetPrototypeOf]](). const proto = Q(yield* targetFunction.GetPrototypeOf()); // 3. Let internalSlotsList be the internal slots listed in Table 30, plus [[Prototype]] and [[Extensible]]. const internalSlotsList = [ 'BoundTargetFunction', 'BoundThis', 'BoundArguments', 'Prototype', 'Extensible', ]; // 4. Let obj be ! MakeBasicObject(internalSlotsList). const obj = X(MakeBasicObject(internalSlotsList)) as Mutable; // 5. Set obj.[[Prototype]] to proto. obj.Prototype = proto; // 6. Set obj.[[Call]] as described in 9.4.1.1. obj.Call = BoundFunctionExoticObjectCall; // 7. If IsConstructor(targetFunction) is true, then if (IsConstructor(targetFunction)) { // a. Set obj.[[Construct]] as described in 9.4.1.2. obj.Construct = BoundFunctionExoticObjectConstruct; } // 8. Set obj.[[BoundTargetFunction]] to targetFunction. obj.BoundTargetFunction = targetFunction as FunctionObject; // 9. Set obj.[[BoundThis]] to boundThis. obj.BoundThis = boundThis; // 10. Set obj.[[BoundArguments]] to boundArguments. obj.BoundArguments = boundArgs; // 11. Return obj. return obj; } /** https://tc39.es/ecma262/#sec-function.prototype.bind */ function* FunctionProto_bind([thisArg = Value.undefined, ...args]: Arguments, { thisValue }: FunctionCallContext): ValueEvaluator { // 1. Let Target be the this value. const Target = thisValue; // 2. If IsCallable(Target) is false, throw a TypeError exception. if (!IsCallable(Target)) { return Throw.TypeError("Expected 'this' value to be a function but got $1", Target); } __ts_cast__(Target); // 3. Let F be ? BoundFunctionCreate(Target, thisArg, args). const F = Q(yield* BoundFunctionCreate(Target, thisArg, args as Arguments)); Q(yield* CopyNameAndLength(F, Target, 'bound', args.length)); return F; } /** https://tc39.es/ecma262/#sec-function.prototype.call */ function* FunctionProto_call([thisArg = Value.undefined, ...args]: Arguments, { thisValue }: FunctionCallContext): ValueEvaluator { // 1. Let func be the this value. const func = thisValue; // 2. If IsCallable(func) is false, throw a TypeError exception. if (!IsCallable(func)) { return Throw.TypeError("Expected 'this' value to be a function but got $1", func); } // 3. Let argList be a new empty List. const argList: Value[] = []; // 4. If this method was called with more than one argument, then in left to right order, starting with the second argument, append each argument as the last element of argList. for (const arg of args) { argList.push(arg!); } // 5. Perform PrepareForTailCall(). PrepareForTailCall(); // 6. Return ? Call(func, thisArg, argList). return Q(yield* Call(func, thisArg, argList)); } /** https://tc39.es/ecma262/#sec-function.prototype.tostring */ export function FunctionProto_toString(_args: Arguments, { thisValue }: FunctionCallContext): ValueCompletion { // 1. Let func be the this value. const func = thisValue; // 2. If Type(func) is Object and func has a [[SourceText]] internal slot and func.[[SourceText]] // is a sequence of Unicode code points and ! HostHasSourceTextAvailable(func) is true, then if (hasSourceTextInternalSlot(func) && X(HostHasSourceTextAvailable(func)) === Value.true) { // Return ! UTF16Encode(func.[[SourceText]]). return Value(func.SourceText); } // 3. If func is a built-in function object, then return an implementation-defined // String source code representation of func. The representation must have the // syntax of a NativeFunction. Additionally, if func has an [[InitialName]] internal // slot and func.[[InitialName]] is a String, the portion of the returned String // that would be matched by `NativeFunctionAccessor? PropertyName` must be the // value of func.[[InitialName]]. if (isBuiltinFunctionObject(func)) { if (func.InitialName instanceof JSStringValue) { return Value(`function ${func.InitialName.stringValue()}() { [native code] }`); } return Value('function() { [native code] }'); } // 4. If Type(func) is Object and IsCallable(func) is true, then return an implementation // dependent String source code representation of func. The representation must have // the syntax of a NativeFunction. if (func instanceof ObjectValue && IsCallable(func)) { return Value('function() { [native code] }'); } // 5. Throw a TypeError exception. return Throw.TypeError('$1 is not a function', func); } /** https://tc39.es/ecma262/#sec-function.prototype-@@hasinstance */ function* FunctionProto_hasInstance([V = Value.undefined]: Arguments, { thisValue }: FunctionCallContext): ValueEvaluator { // 1. Let F be this value. const F = thisValue; // 2. Return ? OrdinaryHasInstance(F, V). return Q(yield* OrdinaryHasInstance(F, V)); } export function bootstrapFunctionPrototype(realmRec: Realm) { const proto = CreateBuiltinFunction( FunctionProto, 0, Value(''), [], realmRec, realmRec.Intrinsics['%Object.prototype%'], ); realmRec.Intrinsics['%Function.prototype%'] = proto; const readonly = { Writable: Value.false, Configurable: Value.false }; assignProps(realmRec, proto, [ ['apply', FunctionProto_apply, 2], ['bind', FunctionProto_bind, 1], ['call', FunctionProto_call, 1], ['toString', FunctionProto_toString, 0], [wellKnownSymbols.hasInstance, FunctionProto_hasInstance, 1, readonly], ]); }