Long Stack Support for ES6 Promises.js

'use strict';

const theGlobal = typeof window === 'object' ? window : global;

const realPromiseConstructor = theGlobal.Promise;

const wrappedPromiseConstructor = function (resolve, reject, progress) {
    const originalPromiseInstance = new realPromiseConstructor(resolve, reject, progress);
    
    // Who called us?  Let's store it.
    const stackWhenCalled = new Error().stack;
    
    const wrappedPromiseInstance = originalPromiseInstance.catch((err) => {
        try {
            err.stack = err.stack || '';
            err.stack += '\nDuring promise started:\n' + stackWhenCalled.split('\n').slice(3).join('\n');
        } catch (err2) {
            console.error("promiseDebugging.reportLongStackTraces had difficulty adding to the stack:", err2);
        }
        return realPromiseConstructor.reject(err);
    });
    
    return wrappedPromiseInstance;
};
Object.setPrototypeOf(wrappedPromiseConstructor, realPromiseConstructor);

theGlobal.Promise = wrappedPromiseConstructor;

Unfortunately, this trick does not work with native async-await, because the engine doesn't call our global promise constructor.

But it does work with transpiled async-await.

NodeJS now does this out of the box, since --async-stack-traces has been enabled by default.