带有自定义 const 枚举的打字稿定义

Question

我正在尝试为库创建 TypeScript 定义文件。

该库有一个接受number 类型参数的方法，但该参数只能是一组特定的数字，所以我想让我的定义说它需要我使用@987654323 创建的枚举类型@。

但是，当我在 .d.ts 中定义我的类时，如下所示：

// definitions/SimpleDefinition.d.ts

/// <reference path="Enums.ts" />

declare class SampleDefinedClass {
    public static SampleMethod(enumArg: Enums.SampleEnum): void;
}

我的枚举是这样的：

// definitions/Enums.ts

export const enum SampleEnum {
    Item1 = 1,
    Item2 = 2
}

我有一个index.d.ts 将两者联系在一起：

// definitions/index.d.ts

/// <reference path="Enums.ts" />
/// <reference path="SampleDefinition.d.ts" />

编译器告诉我这个：

../definitions/SampleDefinition.d.ts(4,41): error TS2503: Cannot find namespace 'Enums'.

我尝试将导入添加到我的 SampleDefinition.d.ts 的顶部，但这导致我的代码文件中无法正确识别该定义。虽然 Visual Studio 和 Visual Studio 代码在实际导入时不会显示错误。

import Enums = require("./Enums");

Main.ts(6,1): error TS2304: Cannot find name 'SampleDefinedClass'.

我尝试了更多的东西，比如使用 AMD 和移动文件，但似乎无法让它工作。有没有办法做到这一点？还是我必须找到另一种方法来做/放弃？

我用这个精确的样本创建了一个GitHub repo。

Answer 1

您的SampleDefinition.d.ts 没有顶级导入或导出，而Enum.ts 有。也就是说，Enums 是一个模块，而SampleDefinition 不是，但您正试图在其中使用Enums。使用较旧（过时的）术语，SampleDefinition.d.ts 是内部模块，Enums 是外部模块，您不能将两者混合在一个应用程序中。

有两种方法可以使它们保持一致：

一种方法是将所有内容都放在内部，而不需要在顶层进行任何导入/导出：

固定Enum.ts：将@​​987654330@ 包裹在namespace 中

namespace Enums {
    export const enum SampleEnum {
        Item1 = 1,
        Item2 = 2
    }
}

固定 Main.ts - 只需删除 import Enums .. 行

/// <reference path="../definitions/index.d.ts" />

console.log(Enums.SampleEnum.Item2);
SampleDefinedClass.SampleMethod(Enums.SampleEnum.Item1);

另一种方式是将所有内容都变成一个模块：

固定SampleDefinition.ts ：使用import 代替reference，使用export 类代替声明它：

import Enums = require("./Enums");


export class SampleDefinedClass {
    public static SampleMethod(enumArg: Enums.SampleEnum): void;
}

固定Main.ts：再次，import 一切都明确而不是reference。这样一来，您就根本不需要definitions/index.d.ts：

import Enums = require("../definitions/Enums");
import {SampleDefinedClass} from "../definitions/SampleDefinition"


console.log(Enums.SampleEnum.Item2);
SampleDefinedClass.SampleMethod(Enums.SampleEnum.Item1);

选择哪种方式取决于您。主要区别在于，对于模块，您的应用程序将在运行时需要模块加载器。没有模块，它可以编译成一个组合脚本文件。这对浏览器很重要（你必须自己提供模块加载器），为节点编译的模块化代码将使用require 并且可以正常工作。

Answer 2

在定义文件中，您必须使用declare 导出枚举。

我从DefinitelyTyped 中查找了一些示例，这里有一个：

export declare enum EDeflateStrategy {
    DEFAULT_STRATEGY = 0,
    FILTERED = 1,
    HUFFMAN_ONLY = 2,
    RLE = 3,
    FIXED = 4,
}

您的代码的问题是您的定义文件似乎正在查看一个 .ts 文件而不是另一个 .d.ts 文件。

如果这是你的库并且它是用 ts 编写的，你可以添加

"declaration": true

在您的 tsconfig.json 文件中，让 tsc 为您生成定义。

如果不是，您可以尝试在 ts 中模拟此库中的内容，并通过启用此选项让 tsc 为您生成声明。