TypeScript .d.ts 语法 - 导出和声明

Question

我需要帮助来了解创建 .d.ts 文件的正确方法。

令我震惊的是有些人使用这种语法：

// lib-a.d.ts
namespace My.Foo.Bar {
  interface IFoo {}
  interface IBar {}
}

对比

// lib-b.d.ts
declare namespace My.Foo.Bar {
  interface IFoo {}
  interface IBar {}
}

对比

// lib-c.d.ts
namespace My.Foo.Bar {
  export interface IFoo {}
  export interface IBar {}
}

对比

// lib-d.d.ts
declare namespace My.Foo.Bar {
  export interface IFoo {}
  export interface IBar {}
}

对比

// lib-e.d.ts
declare module My.Foo.Bar {
  export interface IFoo {}
  export interface IBar {}
}

哪个是正确的？ declare有什么用？导出有什么用？何时使用名称空间与模块？

Answer 1

正确的方法是：

declare namespace NS {
    interface InterfaceTest {
        myProp: string;
    }

    class Test implements InterfaceTest {
        myProp: string;
        myFunction(): string;
    }
}

您始终可以通过编写一些 .ts 文件并使用 --declaration 选项 (tsc test.ts --declaration) 对其进行编译来检查正确的签名。这将生成一个具有正确类型的 d.ts 文件。

例如，上面的声明文件是从以下代码生成的：

namespace NS {
    export interface InterfaceTest {
        myProp: string;
    }

    export class Test implements InterfaceTest {
        public myProp: string = 'yay';

        public myFunction() {
            return this.myProp;
        }
    }   

    class PrivateTest implements InterfaceTest {
        public myPrivateProp: string = 'yay';

        public myPrivateFunction() {
            return this.myProp;
        }
    }
}

TypeScript .d.ts 语法 - 导出和声明

TypeScript .d.ts syntax - export and declare

typescript

visual-studio-2015

typescript-typings

typescript1.8