详解使用Typescript开发node.js项目(简单的环境配置)

2020-06-17 07:12:04易采站长站整理

“target”是编译后的js代码遵循何种规范,可以是es3/es5/es6等等,这里为了对比ts 2.0代码和es6代码的不同,使用了”es6″。

“rootDir”是一个需要注意的地方,它会告诉编译器,此目录下的文件需要经过编译。那么,如果设置了这个选项,又在外部(比如根目录)放置了.ts文件,会怎么样呢?tsc会提示一条类似这样的错误:


“error TS6059: File ‘D:/workplace/nodeWP/testTS/index.ts’ is not under ‘rootDir’ ‘D:/workplace/nodeWP/testTS/src’. ‘rootDir’ is expected to contain all source files.”

并且,在build的目录中,输出的目录结构也会变化:

 

这显然不是我们想要的结果。

解决方案是使用include和exclude属性。按照文档说明,”include” 和 “exclude” 属性指定一个文件glob匹配模式列表。表明需要包含的文件目录或文件,以及需要过滤掉的文件或目录(也可以使用”files”配置项,不过需要一个一个文件录入,”files” 属性明确指定的文件却总是会被包含在内,不管 “exclude” 如何设置。),详见官方文档说明。

所以,添加”./src/**/*”到”include”所指向的数组,就可以指定./src下的所有文件,是我们真正需要被编译的,其他目录将会被排除。

“outDir” 指向了编译后的js代码输出的地方。在文档中也有”outFile”选项,可以把所有的ts文件按照一定顺序规则打包成一个文件,具体可以参考文档。在这里,我们优先使用outDir。

试验一下

在书写完2个配置文件之后,就可以开始撰写代码,并执行编译了。我们试验一下:

在./src/server.ts中,写一段简单的:


interface ICache{
useCache:boolean;
[propName:string]:any;
}
const cache:ICache = {useCache:true};

之后,在终端中输入:

D:workplacenodeWPtestTS>tsc

经过编译,会生成server.js到build目录中:


//server.js
const cache = { useCache: true };

使用.d.ts文件

既然要开发一个项目,显然不会只有这些代码。肯定要用到内建模块和第三方模块。然而,直接导入模块,在.ts文件中是不行的。例如:

这是由于typescript自身的机制,需要一份xx.d.ts声明文件,来说明模块对外公开的方法和属性的类型以及内容。感觉有一些麻烦。好在,官方以及社区已经准备好了方案,来解决这个问题。