为 Node.js 模块中重新导出的 JS 函数生成 TypeScript 声明

Question

我正在尝试为使用 JSDoc 注释的类型和函数发出声明。这些对 TypeScript 用户很有用，从 JSDoc 生成它们意味着我们的 SDK 开发人员的开销更少。

TypeScript 用户应该获得一个名为 Apify 的模块，并从中访问我们的 SDK 功能。

import {Apify} from "apify";

const envs = Apify.getEnv();
...

这不会发生，生成的index.d.ts 包含多个模块，每个 JS 源文件一个。

---

情况

我的 JavaScript 库是客户端代码可见的单个模块。源码由src/目录下的多个文件组成：

• src/index.js
• src/actor.js
• src/request.js
• ...

index.js 文件重新导出其他文件中定义的函数，因此它们可以被运行在 Node.js 中的客户端代码访问。

import { main, getEnv, call, callTask, ... } from './actor';
import Request from './request';
...

/**
 * The following section describes all functions and properties provided by the `apify` package...
 *
 * @module Apify
 */
module.exports = {
    main,
    getEnv,
    ...
    Request,
    ...
};

在package.json中，文件build/index.js被定义为入口点（被babel从src/index.js转译后）：

{
   "main": "build/index.js",
   ...
}

我的tsconfig.json 如下：

{
    "compilerOptions": {
        "target": "esnext",
        "module": "esnext",
        "moduleResolution": "node",
        "lib": [
            "es2017",
            "dom"
        ],
        "allowJs": true,
        "checkJs": false,
        "noEmit": false,
        "declaration": true,
        "emitDeclarationOnly": true,
        "strict": false,
        "noImplicitThis": true,
        "alwaysStrict": true,
        "esModuleInterop": true,
        "outFile": "types/index.d.ts"
    },
    "include": [
        "src/index.js"
    ]
}

---

结果

运行tsc 后，我得到了我的types/index.d.ts，其中包含我的每个JS 源文件的模块声明（客户端代码无法访问它们中的每一个）和一个空的index 模块：

declare module "actor" {
    export function getEnv(): Env;
    export function main(userFunc: Function): void;
    ...
}
declare module "request" { ... }
...

declare module "index" {
    export {};
}

Answer 1

这个问题是因为您使用的是module.exports instead 导出default

改变

/**
 * The following section describes all functions and properties provided by the `apify` package...
 *
 * @module Apify
 */
module.exports = {
    main,
    getEnv,
    ...
    Request,
    ...
};

到

/**
 * The following section describes all functions and properties provided by the `apify` package...
 *
 * @module Apify
 */
export default {
    main,
    getEnv,
    ...
    Request,
    ...
};

然后让我们看看这个文件

actors.js

module.exports = {
    main: () => { console.log("main") },
    getEnv: () => { console.log("getEnv") }
}

request.js

module.exports = {
    Request: () => { console.log("req") }
}

和 index.js

import { main, getEnv } from './actor';
import Request from './request';

/**
 * The following section describes all functions and properties provided by the `apify` package...
 *
 * @module Apify
 */
export default {
    main,
    getEnv,
    Request,
};

使用 module.export

类型文件

declare module "actor" {
    export function main(): void;
    export function getEnv(): void;
}
declare module "request" {
    export function Request(): void;
}
declare module "index" {
    export {};
}

和export default

declare module "actor" {
    export function main(): void;
    export function getEnv(): void;
}
declare module "request" {
    export function Request(): void;
}
declare module "index" {
    namespace _default {
        export { main };
        export { getEnv };
        export { Request };
    }
    export default _default;
    import { main } from "actor";
    import { getEnv } from "actor";
    import Request from "request";
}

Answer 2

你可以在索引上添加这个：

export {main, getEnv} from './actor';