TypeScript中用Bluebird覆盖全局Promise遇类型错误的解决方法

问题 #

本地Node环境自带原生Promise，但远程运行环境没有Promise支持，想要在Promise未定义时用Bluebird全局替换它。试了两段代码都报错：

第一段代码：

import { Promise as BlueBirdPromise } from 'bluebird';

if (!Promise) {
    Promise = BlueBirdPromise;
    Promise.setScheduler((fn: any) => {
        setTimeout(fn, 0);
    });
}

报错原因：TypeScript里Promise是接口，和BlueBirdPromise类型不兼容，无法直接赋值。

第二段代码：

import { Promise as BlueBirdPromise } from 'bluebird';

BlueBirdPromise.setScheduler((fn: any) => {
    setTimeout(fn, 0);
});
// eslint-disable-next-line
Promise = BlueBirdPromise;

报错信息：

polyfills.ts:13:1 - error TS2741: Property '[Symbol.species]' is missing in type 'typeof Bluebird' but required in type 'PromiseConstructor'.

解决办法 #

方式一：用类型断言绕开TS检查 #

直接给BlueBirdPromise做类型断言，让TS认可它符合PromiseConstructor类型，同时只在Promise不存在时替换：

import { Promise as BlueBirdPromise } from 'bluebird';

BlueBirdPromise.setScheduler((fn: any) => setTimeout(fn, 0));

if (typeof Promise === 'undefined') {
    (globalThis as any).Promise = BlueBirdPromise as unknown as PromiseConstructor;
}

用globalThis更标准，避免直接操作全局变量的类型问题，双重断言能让TS通过类型检查。

方式二：扩展全局Promise类型（可选） #

如果需要长期兼容，在项目的类型定义文件（比如global.d.ts）里扩展PromiseConstructor，补上Bluebird缺失的[Symbol.species]属性：

declare global {
    interface PromiseConstructor {
        [Symbol.species]?: PromiseConstructor;
    }
}

这样TS就不会因为这个属性缺失报错，再结合第一段的替换逻辑就能正常运行。

方式三：直接用Bluebird的全局polyfill #

Bluebird本身自带全局替换逻辑，直接引入它的polyfill模式就行，不用自己写判断：

import 'bluebird';

// 手动设置调度器
Promise.setScheduler((fn: any) => setTimeout(fn, 0));

它会自动检测环境里有没有Promise，没有的话就自动全局替换，这是最简洁的方案。

内容的提问来源于stack exchange，提问作者Kris