TypeScript基础入门之Javascript文件类型检查(一)

TypeScript 2.3及更高版本支持使用--checkJs在.js文件中进行类型检查和报告错误。

您可以通过添加//@ts-nocheck注释来跳过检查某些文件; 相反，您可以通过在不设置--checkJs的情况下向其添加//@ts-check注释来选择仅检查几个.js文件。 您还可以通过在前一行添加//@ts-ignore来忽略特定行上的错误。 请注意，如果你有一个tsconfig.json，JS检查将遵循严格的标志，如noImplicitAny，strictNullChecks等。但是，由于JS检查相对松散，将严格的标志与它结合可能会令人惊讶。

以下是.js文件中检查与.ts文件相比如何工作的一些显着差异：

JSDoc类型用于类型信息

在.js文件中，通常可以像.ts文件一样推断类型。 同样，当无法推断类型时，可以使用JSDoc指定它们，就像在.ts文件中使用类型注释一样。 就像Typescript一样， --noImplicitAny会给你编译器无法推断类型的地方的错误。 （开放式对象文字除外;有关详细信息，请参见下文。） 装饰声明的JSDoc注释将用于设置该声明的类型。 例如：

/** @type {number} */
var x;

x = 0;      // OK
x = false;  // Error: boolean is not assignable to number

您可以在JavaScript文档中的JSDoc支持中找到受支持的JSDoc模式的完整列表。

属性是从类体中的赋值推断出来的

ES2015没有在类上声明属性的方法。 属性是动态分配的，就像对象文字一样。

在.js文件中，编译器从类主体内的属性赋值中推断属性。 属性的类型是构造函数中给出的类型，除非它没有在那里定义，或者构造函数中的类型是undefined或null。 在这种情况下，类型是这些赋值中所有右侧值的类型的并集。 始终假定构造函数中定义的属性存在，而仅在方法，getter或setter中定义的属性被视为可选。

class C {
    constructor() {
        this.constructorOnly = 0
        this.constructorUnknown = undefined
    }
    method() {
        this.constructorOnly = false // error, constructorOnly is a number
        this.constructorUnknown = "plunkbat" // ok, constructorUnknown is string | undefined
        this.methodOnly = 'ok'  // ok, but y could also be undefined
    }
    method2() {
        this.methodOnly = true  // also, ok, y's type is string | boolean | undefined
    }
}

如果从未在类体中设置属性，则将它们视为未知。 如果您的类具有仅从中读取的属性，请使用JSDoc在构造函数中添加然后注释声明以指定类型。 如果稍后将初始化，您甚至不必提供值：

class C {
    constructor() {
        /** @type {number | undefined} */
        this.prop = undefined;
        /** @type {number | undefined} */
        this.count;
    }
}


let c = new C();
c.prop = 0;          // OK
c.count = "string";  // Error: string is not assignable to number|undefined

构造函数等同于类

在ES2015之前，Javascript使用构造函数而不是类。 编译器支持此模式，并将构造函数理解为与ES2015类等效。 上述属性推理规则的工作方式完全相同。

function C() {
    this.constructorOnly = 0
    this.constructorUnknown = undefined
}
C.prototype.method = function() {
    this.constructorOnly = false // error
    this.constructorUnknown = "plunkbat" // OK, the type is string | undefined
}

支持CommonJS模块

在.js文件中，Typescript了解CommonJS模块格式。 对exports和module.exports的赋值被识别为导出声明。 同样，require函数调用被识别为模块导入。 例如：

// same as `import module "fs"`
const fs = require("fs");

// same as `export function readFile`
module.exports.readFile = function(f) {
    return fs.readFileSync(f);
}

Javascript中的模块支持比Typescript的模块支持更具语法上的宽容。 支持大多数分配和声明组合。

类，函数和对象文字是名称空间类是.js文件中的命名空间。 这可以用于嵌套类，例如：

class C {
}
C.D = class {
}

并且，对于ES2015之前的代码，它可以用于模拟静态方法：

function Outer() {
  this.y = 2
}
Outer.Inner = function() {
  this.yy = 2
}

它还可以用于创建简单的命名空间：

var ns = {}
ns.C = class {
}
ns.func = function() {
}

// IIFE
var ns = (function (n) {
  return n || {};
})();
ns.CONST = 1

// defaulting to global
var assign = assign || function() {
  // code goes here
}
assign.extra = 1

未完待续...