X-Git-Url: https://git.ladys.computer/Pisces/blobdiff_plain/2edbddced262b90f8422e77fe8ec61a9f8c82e68..6e6d4e3261c1c943fe44fa9e381bcf8bf1441fd6:/object.js?ds=sidebyside diff --git a/object.js b/object.js index a34423e..9986291 100644 --- a/object.js +++ b/object.js @@ -32,39 +32,49 @@ import { toPrimitive, type } from "./value.js"; * object. */ export class LazyLoader extends null { - /** Constructs a new LazyLoader object. */ + /** + * Constructs a new LazyLoader object. + * + * ☡ This function throws if the provided value is not an object. + */ constructor(loadMethods) { - const result = objectCreate(getPrototype(loadMethods)); - const methodKeys = getOwnPropertyKeys(loadMethods); - for (let index = 0; index < methodKeys.length; ++index) { - const methodKey = methodKeys[index]; - const { configurable, enumerable, writable } = - getOwnPropertyDescriptor(loadMethods, methodKey); - defineOwnProperty(result, methodKey, { - configurable: true, - enumerable, - get: () => { - const value = call(loadMethods[methodKey], result, []); - defineOwnProperty(result, methodKey, { - configurable, - enumerable, - value, - writable, - }); - return value; - }, - set: writable - ? ($) => + if (type(loadMethods) !== "object") { + throw new TypeError( + `Piscēs: Cannot construct LazyLoader: Provided argument is not an object: ${loadMethods}.`, + ); + } else { + const result = objectCreate(getPrototype(loadMethods)); + const methodKeys = getOwnPropertyKeys(loadMethods); + for (let index = 0; index < methodKeys.length; ++index) { + const methodKey = methodKeys[index]; + const { configurable, enumerable, writable } = + getOwnPropertyDescriptor(loadMethods, methodKey); + defineOwnProperty(result, methodKey, { + configurable: true, + enumerable, + get: () => { + const value = call(loadMethods[methodKey], result, []); defineOwnProperty(result, methodKey, { configurable, enumerable, - value: $, + value, writable, - }) - : void {}, - }); + }); + return value; + }, + set: writable + ? ($) => + defineOwnProperty(result, methodKey, { + configurable, + enumerable, + value: $, + writable, + }) + : void {}, + }); + } + return result; } - return result; } } @@ -89,12 +99,11 @@ export const { PropertyDescriptor } = (() => { * its `enumerable` property, if defined, will always be a * boolean). */ - //deno-lint-ignore constructor-super constructor(O) { if (type(O) !== "object") { // The provided value is not an object. throw new TypeError( - "Piscēs: Cannot convert primitive to property descriptor.", + `Piscēs: Cannot convert primitive to property descriptor: ${O}.`, ); } else { // The provided value is an object. @@ -573,26 +582,62 @@ export const { * Removes the provided property key from the provided object and * returns the object. * - * ☡ This function differs from Reflect.deleteProperty and the + * ※ This function differs from Reflect.deleteProperty and the * `delete` operator in that it throws if the deletion is * unsuccessful. + * + * ☡ This function throws if the first argument is not an object. */ deleteOwnProperty, + /** + * Returns an array of property keys on the provided object. + * + * ※ This is effectively an alias for Reflect.ownKeys, except that + * it does not require that the argument be an object. + */ + getOwnPropertyKeys, + + /** + * Returns the value of the provided property key on the provided + * object. + * + * ※ This is effectively an alias for Reflect.get, except that it + * does not require that the argument be an object. + */ + getPropertyValue, + + /** + * Returns whether the provided property key exists on the provided + * object. + * + * ※ This is effectively an alias for Reflect.has, except that it + * does not require that the argument be an object. + * + * ※ This includes properties present on the prototype chain. + */ + hasProperty, + /** * Sets the provided property key to the provided value on the * provided object and returns the object. * * ※ This function differs from Reflect.set in that it throws if the * setting is unsuccessful. + * + * ☡ This function throws if the first argument is not an object. */ setPropertyValue, } = (() => { - const { deleteProperty, set } = Reflect; + const { deleteProperty, get, has, ownKeys, set } = Reflect; return { deleteOwnProperty: (O, P) => { - if (!deleteProperty(O, P)) { + if (type(O) !== "object") { + throw new TypeError( + `Piscēs: Tried to set property but provided value was not an object: ${V}`, + ); + } else if (!deleteProperty(O, P)) { throw new TypeError( `Piscēs: Tried to delete property from object but [[Delete]] returned false: ${P}`, ); @@ -600,8 +645,16 @@ export const { return O; } }, + getOwnPropertyKeys: (O) => ownKeys(toObject(O)), + getPropertyValue: (O, P, Receiver = O) => + get(toObject(O), P, Receiver), + hasProperty: (O, P) => has(toObject(O), P), setPropertyValue: (O, P, V, Receiver = O) => { - if (!set(O, P, V, Receiver)) { + if (type(O) !== "object") { + throw new TypeError( + `Piscēs: Tried to set property but provided value was not an object: ${V}`, + ); + } else if (!set(O, P, V, Receiver)) { throw new TypeError( `Piscēs: Tried to set property on object but [[Set]] returned false: ${P}`, ); @@ -615,7 +668,7 @@ export const { export const { /** * Returns a new frozen shallow copy of the enumerable own properties - * of the provided object, according to the following rules :— + * of the provided object, according to the following rules :— * * - For data properties, create a nonconfigurable, nonwritable * property with the same value. @@ -630,6 +683,8 @@ export const { * nonnullish `Symbol.species`, that will be used instead. If the * used constructor or species is nullish or does not have a * `prototype` property, the prototype is set to null. + * + * ※ The prototype of the provided object itself is ignored. */ frozenCopy, } = (() => { @@ -714,46 +769,44 @@ export const { }; })(); -export const { - /** - * Returns an array of property keys on the provided object. - * - * ※ This is an alias for Reflect.ownKeys. - */ - ownKeys: getOwnPropertyKeys, - - /** - * Returns the value of the provided property key on the provided - * object. - * - * ※ This is an alias for Reflect.get. - */ - get: getPropertyValue, - - /** - * Returns whether the provided property key exists on the provided - * object. - * - * ※ This is an alias for Reflect.has. - * - * ※ This includes properties present on the prototype chain. - */ - has: hasProperty, -} = Reflect; +/** + * Returns the function on the provided value at the provided property + * key. + * + * ☡ This function throws if the provided property key does not have an + * associated value which is callable. + */ +export const getMethod = (V, P) => { + const func = getPropertyValue(V, P); + if (func == null) { + return undefined; + } else if (typeof func !== "function") { + throw new TypeError(`Piscēs: Method not callable: ${P}`); + } else { + return func; + } +}; /** * Returns the provided value converted to an object. * - * Null and undefined are converted to a new, empty object. Other - * primitives are wrapped. Existing objects are returned with no - * modification. + * Existing objects are returned with no modification. * - * ※ This is effectively a nonconstructible version of the Object - * constructor. + * ☡ This function throws if its argument is null or undefined. */ export const { toObject } = (() => { const makeObject = Object; - return { toObject: ($) => makeObject($) }; + return { + toObject: ($) => { + if ($ == null) { + throw new TypeError( + `Piscēs: Cannot convert ${$} into an object.`, + ); + } else { + return makeObject($); + } + }, + }; })(); /**