《TypeScript入门教程》笔记
<h2 id="基础">基础</h2><h3 id="布尔值">布尔值</h3>
<pre><code>let isDone: boolean = false;
</code></pre>
<h3 id="数值">数值</h3>
<pre><code>let decLiteral: number = 6;
</code></pre>
<h3 id="字符串">字符串</h3>
<pre><code>let myName: string = 'tom';
</code></pre>
<h3 id="无值">无值</h3>
<p>1.示例</p>
<pre><code>let myName: null = null;
let myName: undefined = undefined;
</code></pre>
<p>2.null/undefined是所有类型的子类型</p>
<pre><code>let val: 其它类型 = undefined;
</code></pre>
<h3 id="空值">空值</h3>
<p>1.关键字为void，只能被赋值undefined和null</p>
<pre><code>let unusable: void = undefined;
</code></pre>
<h3 id="任意值">任意值</h3>
<p>1.可以赋值为任意类型的值（没有类型限制）</p>
<pre><code>let myFavoriteNumber: any = 'seven';
myFavoriteNumber = 7;
</code></pre>
<p>2.对任意值进行任何操作，返回值类型都是任意值</p>
<p>3.变量声明时，如果未指定类型</p>
<pre><code>a.未赋值，则会默认为any类型
let something;
something = 'seven';
something = 7;
b.赋值了，则会被类型推断为所赋值的类型
let myFavoriteNumber = 'seven';
myFavoriteNumber = 7;// 会报错
</code></pre>
<h3 id="联合">联合</h3>
<p>1.表示取值可以为多种类型中的一种</p>
<p>2.示例</p>
<pre><code>let myFavoriteNumber: string | number
myFavoriteNumber = 'seven'
myFavoriteNumber = 7
</code></pre>
<p>3.当不确定联合类型变量的类型时，只能访问此联合类型的所有类型里共有的属性或方法</p>
<pre><code>function getString(something: string | number): string {
return something.toString()
}
</code></pre>
<h3 id="对象">对象</h3>
<p>1.对象的类型由接口定义</p>
<p>2.接口是对行为的抽象，而具体实现则由类去实现</p>
<p>3.示例代码</p>
<pre><code>interface Person {
name: string
age: number
}
let tom: Person = {
name: 'Tom',
age: 25
}
</code></pre>
<p>4.对象定义时，变量的属性数量/形状必须和接口属性数量/形状保持一致</p>
<p>5.可选属性</p>
<pre><code>interface Person {
name: string
age?: number
}
let tom: Person = {
name: 'Tom'
}
</code></pre>
<p>5.可索引属性</p>
<pre><code>interface Person {
name: number
age?: number
: string
}
// 报错 - 确定属性和可选属性的返回值类型必须和它的返回值类型匹配，或者是它的返回值类型的子集
class Animal {
name: string;
}
class Dog extends Animal {
breed: string;
}
// 错误 - 可索引的属性可以多个，数字索引的返回值必须是字符串索引返回值类型的子类型
interface NotOkay {
: Animal;
: Dog;
}
</code></pre>
<p>6.只读属性</p>
<pre><code>interface Person {
readonly id: number
age: number
}
let tom: Person = {
id: 10,
age: 25
}
tom.id = 89757 // 报错
</code></pre>
<h3 id="数组">数组</h3>
<p>1.类型+方括号表示法</p>
<pre><code>let arr: number[] = ;
let arr: number[] = ; // 会报错
arr.push('5'); // 会报错
</code></pre>
<p>2.数组泛型</p>
<pre><code>let fibonacci: Array<number> =
</code></pre>
<p>3.接口表示数组</p>
<pre><code>interface NumberArray {
: number
}
let fibonacci: NumberArray =
</code></pre>
<p>4.any数组</p>
<ul>
<li>用any表示数组中允许出现任意类型</li>
<li>示例</li>
</ul>
<pre><code>let list: any[] = ['xjh', 25, { key: 'xx' }]
</code></pre>
<p>5.类数组</p>
<ul>
<li>a.常见的类数组都有自己的接口定义，如 IArguments, NodeList, HTMLCollection</li>
<li>b.示例</li>
</ul>
<pre><code>function sum() {
let args: IArguments = arguments
}
</code></pre>
<h3 id="函数">函数</h3>
<p>1.函数声明</p>
<ul>
<li>示例</li>
</ul>
<pre><code>function sum(x: number, y: number): number {
return x + y;
}
</code></pre>
<ul>
<li>输入多余/少于要求的参数，是不被允许的</li>
</ul>
<pre><code>sum(1, 2, 3) // 报错
sum(1) // 报错
</code></pre>
<p>2.函数表达式</p>
<ul>
<li>示例</li>
</ul>
<pre><code>let mySum: (x: number, y: number) => number = function (x, y) {
return x + y
}
</code></pre>
<ul>
<li>=>用来表示函数的定义，左边是输入类型，需要用括号括起来，右边是输出类型</li>
</ul>
<p>3.用接口定义函数的形状</p>
<pre><code>interface SearchFunc {
(source: string, subString: string): boolean
}
let mySearch: SearchFunc = function(source, subString) {
return source.search(subString) !== -1
}
</code></pre>
<p>4.可选参数</p>
<ul>
<li>可选参数，必须接在必需参数后面</li>
<li>可选参数，后面不允许再出现必须参数</li>
</ul>
<p>5.参数默认值</p>
<ul>
<li>同ES6</li>
<li>会将添加了默认值的参数，识别为可选参数</li>
<li>不受"可选参数必须接在必需参数后面"的限制</li>
</ul>
<p>6.剩余参数</p>
<ul>
<li>同ES6</li>
</ul>
<p>7.重载</p>
<ul>
<li>允许一个函数接受不同数量或类型的参数时，作出不同的处理</li>
<li>示例</li>
</ul>
<pre><code>function reverse(x: number): number
function reverse(x: string): string
function reverse(x: number | string): number | string {
if (typeof x === 'number') {
return Number(x.toString().split('').reverse().join(''))
} else if (typeof x === 'string') {
return x.split('').reverse().join('');
}
}
</code></pre>
<ul>
<li>如果多个函数定义有包含关系，需要优先把精确的定义写在前面</li>
</ul>
<h2 id="进阶">进阶</h2>
<h3 id="类型推断">类型推断</h3>
<h4 id="定义">定义</h4>
<ul>
<li>如果没有明确指定类型，那么ts会依照类型推论规则推断出一个类型</li>
</ul>
<h4 id="代码示例">代码示例</h4>
<pre><code>let myFavoriteNumber = 'seven';
myFavoriteNumber = 7; // 报错，因为已推断为字符串
</code></pre>
<h4 id="强调">强调</h4>
<ul>
<li>如果定义的时候没有赋值，会被推断成any类型</li>
</ul>
<pre><code>let myFavoriteNumber;
myFavoriteNumber = 'seven';
myFavoriteNumber = 7;
</code></pre>
<h3 id="类型断言">类型断言</h3>
<p>1.手动指定一个值的类型，然后才可以使用类型对应的方法，否则只能访问公共属性/方法</p>
<pre><code>function getLength(something: string | number): number {
if ((<string>something).length) {
return (<string>something).length;
} else {
return something.toString().length;
}
}
</code></pre>
<p>2.方法</p>
<ul>
<li><类型>值</li>
<li>值 as 类型</li>
</ul>
<p>3.断言成一个联合类型中不存在的类型是不允许的</p>
<pre><code>function toBoolean(something: string | number): boolean {
return <boolean>something
}
</code></pre>
<h3 id="类型别名">类型别名</h3>
<h4 id="定义-1">定义</h4>
<ul>
<li>用来给一个类型起个新名字</li>
</ul>
<h4 id="示例代码">示例代码</h4>
<pre><code>type Name = string;
type NameResolver = () => string;
type NameOrResolver = Name | NameResolver;
</code></pre>
<h3 id="字符串字面量类型">字符串字面量类型</h3>
<h4 id="定义-2">定义</h4>
<ul>
<li>用来约束取值只能是某几个字符串中的一个</li>
</ul>
<h4 id="示例代码-1">示例代码</h4>
<pre><code>type EventNames = 'click' | 'scroll' | 'mousemove';
function handleEvent(ele: Element, event: EventNames) {}
</code></pre>
<h4 id="注意">注意</h4>
<ul>
<li>类型别名与字符串字面量类型都是使用type进行定义</li>
</ul>
<h3 id="元祖tuple">元祖Tuple</h3>
<h4 id="定义-3">定义</h4>
<ul>
<li>数组合并了相同类型的对象，而元组合并了不同类型的对象</li>
</ul>
<h4 id="示例">示例</h4>
<pre><code>let tom: = ['Tom', 25];
</code></pre>
<h4 id="注意-1">注意</h4>
<p>1.当赋值或访问一个已知索引的元素时，可以只赋值其中一项</p>
<pre><code>let tom: ;
tom = 'Tom';
</code></pre>
<p>2.直接对元祖类型赋值时，需提供所有类型项</p>
<pre><code>let tom: ;
tom = ['Tom', 25];
</code></pre>
<p>3.当添加越界元素时，类型会被限制为定义项的类型</p>
<pre><code>let tom: ;
tom = ['Tom', 25];
tom.push('male');
tom.push(true); // 报错
</code></pre>
<h3 id="枚举">枚举</h3>
<h4 id="定义-4">定义</h4>
<ul>
<li>用于取值被限定在一定范围内的场景</li>
</ul>
<h4 id="简单示例">简单示例</h4>
<pre><code>enum Days {Sun, Mon, Tue, Wed, Thu, Fri, Sat};
console.log(Days["Sun"] === 0); // true
console.log(Days === "Sun"); // true
</code></pre>
<h4 id="手动赋值">手动赋值</h4>
<pre><code>enum Days {Sun = 7, Mon = 1, Tue, Wed, Thu, Fri, Sat};
console.log(Days["Sun"] === 7); // true
console.log(Days["Mon"] === 1); // true
console.log(Days["Sat"] === 6); // true
</code></pre>
<h4 id="说明">说明</h4>
<ul>
<li>未手动赋值的枚举项会接着上一个枚举项递增</li>
<li>未手动赋值的枚举项与手动赋值的重复了，ts不会察觉，后者只会覆盖前者</li>
</ul>
<h4 id="枚举项类型">枚举项类型</h4>
<p>1.常数项和计算所得项</p>
<p>2.计算所得项·示例</p>
<pre><code>enum Color { Red, Green, Blue = "blue".length };
</code></pre>
<p>3.如果紧接在计算所得项后面的是未手动赋值的项，那么它就会因为无法获得初始值而报错</p>
<pre><code>enum Color { Red = "red".length, Green, Blue }; // 报错
</code></pre>
<h4 id="常数枚举">常数枚举</h4>
<p>1.示例代码</p>
<pre><code>const enum Directions {
Up,
Down,
Left,
Right
}
let directions = [ Directions.Up, Directions.Down, Directions.Left, Directions.Right ];
var directions = ; //编译结果
</code></pre>
<p>2.常数枚举与普通枚举的区别是，它会在编译阶段被删除，并且不能包含计算所得项</p>
<pre><code>const enum Color {Red, Green, Blue = "blue".length};// 报错
</code></pre>
<h4 id="外部枚举">外部枚举</h4>
<p>1.示例代码</p>
<pre><code>declare enum Directions {
Up,
Down,
Left,
Right
}
let directions = ;
var directions = ; //编译结果
</code></pre>
<p>2.declare 定义的类型只会用于编译时的检查，编译结果中会被删除</p>
<p>3.外部枚举与声明语句一样，常出现在声明文件中</p>
<h3 id="类">类</h3>
<h4 id="概言">概言</h4>
<ul>
<li>TS除了实现了所有ES6中的类的功能以外，还添加了一些新的用法</li>
</ul>
<h4 id="修饰符">修饰符</h4>
<pre><code>public 可被公开访问
private 仅供自身访问，子类也不可以访问它的属性/方法
protected 受保护的访问，子类可以访问它的属性/方法
</code></pre>
<h4 id="抽象类">抽象类</h4>
<ul>
<li>用abstract关键字定义（抽象类/抽象方法）</li>
<li>不允许被实例化</li>
<li>抽象方法必须被子类实现</li>
<li>抽象类可以包含成员的实现细节</li>
</ul>
<h3 id="类与接口">类与接口</h3>
<h4 id="类实现接口">类实现接口</h4>
<ul>
<li>把各层级的类之间共有的特性提取出来进行实现的部分叫接口</li>
<li>接口通过interface定义，通过implements实现</li>
<li>一个类只能继承一个类，但是可以实现多个接口</li>
<li>接口不会帮你检查类是否具有某些私有成员</li>
<li>接口只会对类的实例部分进行类型检查</li>
</ul>
<h4 id="接口继承接口">接口继承接口</h4>
<ul>
<li>通过extends关键字来继承</li>
<li>接口可以继承多个接口</li>
</ul>
<h4 id="接口继承类">接口继承类</h4>
<ul>
<li>通过extends关键字来继承</li>
<li>在接口继承类的时候，也只会继承它的实例属性和实例方法</li>
<li>接口继承了拥有私有或受保护成员的类时，这个接口只能被这个类或其子类所实现</li>
</ul>
<h3 id="泛型">泛型</h3>
<h4 id="定义-5">定义</h4>
<ul>
<li>
<p>在定义函数、接口或类的时候，不预先指定具体的类型，而在使用的时候再指定类型的一种特性</p>
</li>
<li>
<p>示例代码</p>
</li>
</ul>
<pre><code>function createArray<T>(length: number, value: T): Array<T> {
let result: T[] = [];
for (let i = 0; i < length; i++) {
result = value;
}
return result;
}
createArray<string>(3, 'x'); // ['x', 'x', 'x']
</code></pre>
<h4 id="多个类型参数">多个类型参数</h4>
<pre><code>function swap<T, U>(tuple: ): {
return , tuple];
}
swap(); // ['seven', 7]
</code></pre>
<h4 id="泛型默认类型">泛型默认类型</h4>
<pre><code>function createArray<T = string>(length: number, value: T): Array<T> {
let result: T[] = [];
for (let i = 0; i < length; i++) {
result = value
}
return result;
}
</code></pre>
<h4 id="泛型约束">泛型约束</h4>
<p>1.由于事先不知道它是哪种类型，所以不能随意的操作它的属性或方法</p>
<pre><code>function loggingIdentity<T>(arg: T): T {
console.log(arg.length); // 报错
return arg;
}
</code></pre>
<p>2.对泛型进行约束</p>
<pre><code>interface Lengthwise {
length: number;
}
function loggingIdentity<T extends Lengthwise>(arg: T): T {
console.log(arg.length);
return arg;
}
</code></pre>
<p>3.泛型之间也可以相互约束</p>
<pre><code>function copyFields<T extends U, U>(target: T, source: U): T {
for (let id in source) {
target = (<T>source);
}
return target;
}
let x = { a: 1, b: 2, c: 3, d: 4 };
copyFields(x, { b: 10, d: 20 });
</code></pre>
<p>4.在泛型约束中使用类型参数</p>
<pre><code>function getProperty<T, K extends keyof T> (obj: T, key: K ) {
return obj
}
let x = {a: 1, b: 2, c: 3, d: 4}
getProperty(x, 'a') // okay
getProperty(x, 'm') // error
</code></pre>
<h4 id="泛型接口">泛型接口</h4>
<pre><code>写法一
interface A {
<T>(arg: T): T;
}
function fn<T>(arg: T): T {
return arg;
}
let test: A = fn;
test<number>(1); // 手动指定-在调用时 传递 泛型参数类型
test(1); // 类型推断-在调用时 推断 泛型参数类型
写法二
interface A<T> {
(arg: T): T;
}
function fn<T>(arg: T): T {
return arg;
}
let test: A<number> = fn; // 接口定义了需要传递类型参数T，这里为number
test<number>(1) // 报错，因为类型定义A<number>已经指定
test('1'); // 报错，必须符合接口A<number>参数类型
</code></pre>
<h4 id="泛型类">泛型类</h4>
<pre><code>class GenericNumber<T> {
zeroValue: T;
add: (x: T, y: T) => T;
}
</code></pre>
<h2 id="声明文件">声明文件</h2>
<h3 id="概要">概要</h3>
<p>1.使用第三方库时，需要引用它的声明文件，才能获得对应的代码补全、接口提示等功能</p>
<p>2.声明语句中只能定义类型，切勿在声明语句中定义具体的实现</p>
<p>3.示例代码</p>
<pre><code>declare var jQuery: (selector: string) => any
</code></pre>
<p>4.注意</p>
<ul>
<li>带有声明语句的文件即为声明文件</li>
<li>声明文件必需以 .d.ts为后缀</li>
<li>如果ts无法解析声明文件，检查tsconfig.json中的files、include和exclude配置，确保其包含了对应库的xx.d.ts文件</li>
</ul>
<p>5.第三方声明文件</p>
<ul>
<li>通常使用@types统一管理第三方库的声明文件</li>
<li>示例</li>
</ul>
<pre><code>npm install @types/jquery --save-dev
</code></pre>
<h3 id="声明合并">声明合并</h3>
<p>1.如果定义了两个相同名字的函数、接口或类，那么它们会合并成一个类型</p>
<p>2.合并的属性类型必须是唯一的</p>
<p>3.函数合并</p>
<ul>
<li>参考函数重载示例</li>
</ul>
<p>4.接口合并</p>
<pre><code>interface Alarm {
price: number;
}
interface Alarm {
weight: number;
}
// 等同于
interface Alarm {
price: number;
weight: number;
}
</code></pre>
<p>5.类合并</p>
<ul>
<li>与接口的合并规则一致</li>
</ul>
<h3 id="书写声明文件">书写声明文件</h3>
<p>1.声明合并</p>
<ul>
<li>一个东西既可以是函数，也可以是对象(拥有子属性)</li>
<li>示例</li>
</ul>
<pre><code>declare function jQuery(selector: string): any
declare namespace jQuery {
function ajax(url: string, settings?: any): void
}
</code></pre>
<p>2.export</p>
<ul>
<li>声明文件中禁止定义具体的实现</li>
<li>interface前是不需要declare的</li>
</ul>
<p>3.export default</p>
<ul>
<li>只有 function、class 和interface可以直接默认导出，其他变量需先声明，再默认导出</li>
<li>一般会将导出语句放在整个声明文件的最前面</li>
</ul>
<p>4.commonjs规范下的export</p>
<ul>
<li>commonjs导出</li>
</ul>
<pre><code>module.exports = foo; // 整体导出
exports.bar = bar; // 单个导出
</code></pre>
<ul>
<li>在导入方式上，有两种跟es6语法相同</li>
<li>官推导入方式（commonjs下）</li>
</ul>
<pre><code>import foo = require('foo'); // 整体导入
import bar = foo.bar; // 单个导入
</code></pre>
<ul>
<li>官推导出方式（commonjs下）（假如要为它写类型声明文件的话）</li>
</ul>
<pre><code>export = foo
declare function foo(): string
</code></pre>
<ul>
<li>两种官推方式都是ts为了兼容AMD和commonjs规范而创立的</li>
</ul>
<p>5.UMD库的导出</p>
<pre><code>export as namespace '导出名'
</code></pre>
<p>6.在npm包/UMD库中扩展全局变量</p>
<pre><code>declare global {
interface String {
prependHello(): string
}
}
</code></pre>
<p>7.模块插件(declare module)</p>
<pre><code>// index.d.ts声明
import * as moment from 'moment';
declare module 'moment' {
export function foo(): moment.CalendarKey
}
// index.ts使用
import * as moment from 'moment';
import 'moment-plugin';
moment.foo();
</code></pre>
<p>8.声明文件中的依赖</p>
<ul>
<li>示例参考<模块插件index.d.ts声明></li>
<li>三斜杠指令
<ul>
<li>早期版本中为了描述模块之间的依赖关系而创造的语法</li>
<li>使用场景：书写一个全局变量，并且需要依赖一个全局变量声明文件时</li>
<li>示例</li>
</ul>
</li>
</ul>
<pre><code>/// <reference types="jquery" />
declare function foo(options: JQuery.AjaxSettings): string
</code></pre>
<ul>
<li>三斜线指令必须放在文件的最顶端，它前面只允许出现单行或多行注释</li>
</ul>
<ul>
<li>拆分声明文件
<ul>
<li>示例</li>
</ul>
</li>
</ul>
<pre><code>/// <reference types="sizzle" />
/// <reference path="JQueryStatic.d.ts" />
/// <reference path="JQuery.d.ts" />
/// <reference path="misc.d.ts" />
/// <reference path="legacy.d.ts" />
export = jQuery;
</code></pre>
<ul>
<li>types用于声明对另一个库的依赖，path用于声明对另一个文件的依赖</li>
</ul>
<p>9.自动生成声明文件</p>
<ul>
<li>命令行
<ul>
<li>在命令行中添加--declaration（简写-d）</li>
</ul>
</li>
<li>配置文件
<ul>
<li>在tsconfig.json中添加declaration选项</li>
<li>示例代码</li>
</ul>
</li>
</ul>
<pre><code>{
"compilerOptions": {
"module": "commonjs",
"outDir": "lib",
"declaration": true
}
}
</code></pre>
<h3 id="发布声明文件">发布声明文件</h3>
<p>1.将声明文件和源码放在一起（ts声明查找也遵循a=>b=>c）</p>
<ul>
<li>package.json中配置types或typings字段，指定声明文件</li>
<li>在项目根目录下，放置一个index.d.ts声明文件</li>
<li>针对package.json的入口文件位置，放置一个声明文件</li>
</ul>
<p>2.将声明文件发布到@types下</p>
<ul>
<li>与普通的npm模块不同，@types统一由DefinitelyTyped管理</li>
</ul>
<h3 id="内置对象的声明文件">内置对象的声明文件</h3>
<ul>
<li>TypeScript核心库定义中，包含了所有游览器环境用到的类型（ECMAScript，DOM和BOM标准）</li>
<li>TypeScript核心库定义中，不包含Nodejs部分（需要npm install @types/node --save-dev）</li>
</ul><br><br>
来源：https://www.cnblogs.com/kanyu/p/11777191.html
頁:
[1]