如何为导出函数的节点模块编写打字稿定义文件?

时间:2014-06-04 05:09:16

标签: typescript commonjs

考虑一下,对于toml节点模块,我可以简单地使用:

// toml.d.ts
declare module TOML {
    export function parse(value:string):any;
}

declare module "toml" {
    export = TOML;
}

然后:

/// <reference path="../../../../../defs/toml/toml.d.ts"/>
import toml = require('toml');
toml.parse(...);

但是,节点模块只导出一个函数,例如'glob'(https://github.com/isaacs/node-glob)。

此模块的节点用法为:

var glob = require("glob")
glob("*.js", {}, callback(err, files) { ... });

你天真地期望你能做到这一点:

// glob.d.ts
declare function globs(paths:string, options:any, callback:{(err:any, files:string[]):void;

...但是因为typescripts'import'语义有点奇怪,所以你似乎只能使用'import .. = require()'语句来别名 modules 。试着打电话:

/// <reference path="../../../../../defs/glob/glob.d.ts"/>
import blog = require('glob');

结果:

error TS2072: Module cannot be aliased to a non-module type.

那么,您将如何为此编写定义文件?

NB。请注意,这是针对使用节点的 commonjs 模块,不是 AMD模块。

...也是的,我知道你可以通过使用declare打破类型系统来做到这一点,但我试图避免这样做:

declare var require;
var glob = require('glob');
glob(...); 

2 个答案:

答案 0 :(得分:11)

使用export =

定义:

// glob.d.ts
declare module 'glob' {
    function globs(paths: string, options: any, callback: (err: any, files: string[]) => void);
    export = globs;
}

用法:

/// <reference path="glob.d.ts"/>

import glob = require('glob');
glob("*.js", {}, (err, files) => { });

答案 1 :(得分:2)

Basarat的答案不适用于typescript 2.1.5。您需要使用export =声明函数并导出:

export = MyFunction;
declare function MyFunction(): string;

How to write a definition file for commonjs module that exports function