typescript中的esModuleInterop选项

当没有加esModuleInterop时

库的代码：

export const a = 1;
export default function b() {}

生成代码

exports.__esModule = true;
exports.a = 1;
function b() { }
exports["default"] = b;

使用库的代码：

import * as lib from './export';

console.log(lib);

生成代码

exports.__esModule = true;
var lib = require("./export");
console.log(lib);

import lib from './export';

console.log(lib);

生成代码

exports.__esModule = true;
var export_1 = require("./export");
console.log(export_1["default"]);

以上代码使用ts生成代码都是可以的。

但是如果我们使用的库是第三方的，比如fs。我们的代码如下

import fs from 'fs';

console.log(fs);

生成代码

exports.__esModule = true;

var fs_1 = require("fs");
console.log(fs_1["default"]);

fs是没有default属性的，所以这种使用fs的方法是不对的。

所以，不加esModuleInterop时，正确引用fs的方法是下面这样：

import * as fs from 'fs';
console.log(fs);

// 或者

import {fsync} from 'fs';
console.log(fsync);

加上esModuleInterop，代码

import * as lib from './export';

console.log(lib);

编译为：

var __importStar = (this && this.__importStar) || function (mod) {
    if (mod && mod.__esModule) return mod;
    var result = {};
    if (mod != null) for (var k in mod) if (Object.hasOwnProperty.call(mod, k)) result[k] = mod[k];
    result["default"] = mod;
    return result;
};
exports.__esModule = true;
var lib = __importStar(require("./export"));
console.log(lib);

代码

import lib from './export';

console.log(lib);

编译为

var __importDefault = (this && this.__importDefault) || function (mod) {
    return (mod && mod.__esModule) ? mod : { "default": mod };
};
exports.__esModule = true;
var export_1 = __importDefault(require("./export"));
console.log(export_1["default"]);

这时

import fs from 'fs';

console.log(fs);

就可以正常使用了。

总结：

因为很多老的js库使用了commonjs的导出方式，并且没有导出default属性，而是使用module.exports=xxx直接导出，这样会导致 import fs from 'fs';的语法引入失败。

typescript为了兼容这些js库，于是引入了esModuleInterop，使import fs from 'fs'能正常使用。