Promise.reject

Requirements

• Export a named function promiseReject. Do not replace or modify the global Promise constructor.
• Always return a new native Promise rejected with the supplied reason. Preserve primitive values and object identity without wrapping reasons in Error.
• Calling the function without an argument must reject with undefined.
• Promises and thenables are ordinary rejection reasons here. Do not await them, read their then property, or invoke then.
• Rejection handlers must run asynchronously, as native Promise handlers do. Calling promiseReject must not synchronously throw the reason.
• Use the native Promise constructor and its reject callback. Do not call Promise.reject or a native combinator to implement the function.
• Custom Promise constructors, subclasses, and species behavior are outside scope.

Examples

Input: promiseReject("offline").catch((reason) => reason)
Output: "offline"

Input: promiseReject().catch((reason) => reason)
Output: undefined

Input: const reason = { code: 503 }; promiseReject(reason).catch((error) => error === reason)
Output: true

Input: const reason = Promise.resolve(1); promiseReject(reason).catch((error) => error === reason)
Output: true