主頁 > 企業開發 > Typescript 最佳實踐

Typescript 最佳實踐

2020-10-06 06:39:12 企業開發

文章串列: 

  • 《一》大話 TypeScript 基本型別

  • 《二》大話 Typescript 列舉

  • 《三》大話 Typescript 介面

  • 《四》大話 Typescript 泛型

  • 《五》大話 Typescript 函式與類

  • 《六》Typescript 最佳實踐

 

為了更好的閱讀體驗,  可以看. 

 

一年前剛接觸 Typescript 的時候, 覺得它加大了代碼作業量. 寫一大堆東西.為了找某個型別東奔西跑, 引入第三庫還經常報錯. 

然而現在的我想說: 真香. 

我們經常吐槽別人代碼可維護性特別低, 總是希望別人能夠主動的寫注釋, 可是寫注釋卻沒有任何方式可以進行約束. 這下好了, 型別就是最好的注釋, 用 Typescript, 可以大大提高代碼的可維護性. 

 

 

一. 如何處理第三方庫型別相關問題

Typescipt 所提供的第三方庫型別定義不僅約束我們的輸入呼叫, 還能為我們提供檔案. 現在, NPM 上的第三方型別定義種類繁多,很難保證型別定義是正確的. 也很難保證所有使用的第三方庫都有型別定義. 

那么, 在這個充滿未知的程序中,如何才能正確使用TypeScript中的第三方庫呢?

 

下面列舉了四種常見的無法正常作業的場景以及對應的解決方法:

  • 庫本身沒有自帶型別定義

  • 庫本身沒有型別定義, 也沒有相關的@type

  • 型別宣告庫有誤

  • 型別宣告報錯

 

1. 庫本身沒有自帶型別定義

查找不到相關的庫型別. 舉個栗子 

在初次將 react 改造支持 typescript 時, 想必很多人都會遇到 module.hot 報錯. 此時只需要安裝對應的型別庫即可. 

安裝 @types/webpack-env

 

2. 庫本身沒有型別定義, 也沒有相關的@type

那只能自己宣告一個了. 隨便舉個栗子. 

declare module "lodash"

 

3. 型別宣告庫有誤

  • 推動解決官方型別定義的問題, 提issue, pr 

  • Import 后通過 extends 或者 merge 能力對原型別進行擴展

  • 忍受型別的丟失或不可靠性

  • 使用 // @ts-ignore  忽略

 

4. 型別宣告報錯

  • 在 compilerOptions 的添加"skipLibCheck": true, 曲線救國

 

二. 巧用型別收縮解決報錯下面列舉了幾種常見的解決方法:

  • 型別斷言

  • 型別守衛 typeof in instanceof 字面量型別保護

  • 雙重斷言

 

1、 型別斷言

型別斷言可以明確的告訴 TypeScript 值的詳細型別,

在某些場景, 我們非常確認它的型別, 即使與 typescript 推斷出來的型別不一致. 那我們可以使用型別斷言. 

語法如下: 

<型別>值

 

值 as 型別 // 推薦使用這種語法. 因為<>容易跟泛型, react 中的語法起沖突

 

舉個例子, 如下代碼,  padding 值可以是 string , 也可以是 number, 雖然在代碼里面寫了 Array(), 我們明確的知道, padding 會被parseint 轉換成 number 型別, 但型別定義依然會報錯. 

 

function padLeft(value: string, padding: string | number) {

   // 報錯: Operator '+' cannot be applied to

   // types 'string | number' and 'number'

   return Array(padding + 1).join(" ") + value;

}

 

解決方法, 使用型別斷言. 告訴 typescript 這里我確認它是 number 型別, 忽略報錯. 

function padLeft(value: string, padding: string | number) {

   // 正常

   return Array(padding as number + 1).join(" ") + value;

}

 

但是如果有下面這種情況, 我們要寫很多個 as 么? 

function padLeft(value: string, padding: string | number) {

   console.log((padding as number) + 3);

   console.log((padding as number) + 2);

   console.log((padding as number) + 5);

   return Array((padding as number) + 1).join(' ') + value;

}

 

2、 型別守衛

型別守衛有以下幾種方式, 簡單的概括以下

  • typeof:  用于判斷 "number","string","boolean"或 "symbol" 四種型別. 

  • instanceof : 用于判斷一個實體是否屬于某個類

  • in: 用于判斷一個屬性/方法是否屬于某個物件

  • 字面量型別保護

 

上面的例子中, 是 string | number 型別, 因此使用 typeof 來進行型別守衛. 例子如下: 

function padLeft(value: string,padding: string | number) {

   if (typeof padding === 'number') {

       console.log(padding + 3); //正常

       console.log(padding + 2); //正常

       console.log(padding + 5); //正常

        //正常

       return Array(padding + 1).join(' ') value;

   }

   if (typeof padding === 'string') {

       return padding + value;

   }

}

 

相比較 型別斷言 as , 省去了大量代碼. 除了 typeof , 我們還有幾種方式, 下面一一舉例子. 

 

  • instanceof :用于判斷一個實體是否屬于某個類

class Man {

   handsome = 'handsome';

}

 

class Woman {

   beautiful = 'beautiful';

}

 

function Human(arg: Man | Woman) {

   if (arg instanceof Man) {

       console.log(arg.handsome);

       console.log(arg.beautiful); // error

   } else {

       // 這一塊中一定是 Woman

       console.log(arg.beautiful);

   }

}

 

  • in : 用于判斷一個屬性/方法是否屬于某個物件

interface B {

   b: string;

}

 

interface A {

   a: string;

}

 

function foo(x: A | B) {

   if ('a' in x) {

       return x.a;

   }

   return x.b;

}

 

  • 字面量型別保護

有些場景, 使用 in, instanceof, typeof 太過麻煩. 這時候可以自己構造一個字面量型別. 

type Man = {

   handsome: 'handsome';

   type: 'man';

 

};

 

type Woman = {

   beautiful: 'beautiful';

   type: 'woman';

};

 

function Human(arg: Man | Woman) {

   if (arg.type === 'man') {

       console.log(arg.handsome);

       console.log(arg.beautiful); // error

   } else {

       // 這一塊中一定是 Woman

       console.log(arg.beautiful);

   }

}

 

3、雙重斷言

有些時候使用 as 也會報錯,因為 as 斷言的時候也不是毫無條件的. 它只有當S型別是T型別的子集,或者T型別是S型別的子集時,S能被成功斷言成T. 

所以面對這種情況, 只想暴力解決問題的情況, 可以使用雙重斷言. 

function handler(event: Event) {

   const element = event as HTMLElement;

   // Error: 'Event' 和 'HTMLElement'

    中的任何一個都不能賦值給另外一個

}

 

如果你仍然想使用那個型別,你可以使用雙重斷言,首先斷言成兼容所有型別的any

 

function handler(event: Event) {

   const element = (event as any) as HTMLElement;

    // 正常

}

 

三. 巧用 typescript 支持的 js 最新特性優化代碼

1. 可選鏈 Optional Chaining 

 

let x = foo?.bar.baz();

 

 

typescript 中的實作如下: 

var _a;

let x = (_a = foo) === null ||

_a === void 0 ? void 0 : _a.bar.baz();

 

利用這個特性, 我們可以省去寫很多惡心的 a && a.b && a.b.c 這樣的代碼

 

2. 空值聯合 Nullish Coalescing

 

let x = foo ?? '22';

 

 

typescript 中的實作如下: 

 

let x = (foo !== null && foo !== void 0 ?

foo : '22');

 

 

 

四. 巧用高級型別靈活處理資料typescript 提供了一些很不錯的工具函式. 如下圖

 

 

 

 

  • 型別索引

為了實作上面的工具函式, 我們需要先了解以下幾個語法: 

keyof : 獲取型別上的 key 值

extends : 泛型里面的約束

T[K] : 獲取物件 T 相應 K 的元素型別

 

type Partial<T> = {

   [P in keyof T]?: T[P]

}

 

在使用 props 的時候, 有時候全部屬性都是可選的, 如果一個一個屬性寫 ? , 大量的重復動作. 這種時候可以直接使用 Partial<State>  

 

Record 作為一個特別靈活的工具. 第一個泛型傳入物件的key值, 第二個傳入 物件的屬性值. 

type Record<K extends string, T> = {

   [P in K]: T;

}

 

我們看一下下面的這個物件, 你會怎么用 ts 宣告它? 

const AnimalMap = {

   cat: { name: '貓', title: 'cat' },

   dog: { name: '狗', title: 'dog' },

   frog: { name: '蛙', title: 'wa' },

};

 

此時用 Record 即可. 

type AnimalType = 'cat' | 'dog' | 'frog';

 

interface AnimalDescription {

name: string, title: string

}

 

const AnimalMap:

Record<AnimalType, AnimalDescription> = {

   cat: { name: '貓', title: 'cat' },

   dog: { name: '狗', title: 'dog' },

   frog: { name: '蛙', title: 'wa' },

};

 

  • never, 構造條件型別

除了上面的幾個語法. 我們還可以用 never , 構造條件型別來組合出更靈活的型別定義. 

語法: 

never: 從未出現的值的型別

 

// 如果 T 是 U 的子型別的話,那么就會回傳 X,否則回傳 Y

構造條件型別 : T extends U ? X : Y

 

type Exclude<T, U> = T extends U ? never : T;

 

// 相當于: type A = 'a'

type A = Exclude<'x' | 'a', 'x' | 'y' | 'z'>

 

  • 更簡潔的修飾符: - 與 + 

可以直接去除 ? 將所有物件屬性變成必傳內容. 

type Required<T> = { [P in keyof T]-?: T[P] };

 

// Remove readonly

type MutableRequired<T> = {

    -readonly [P in keyof T]: T[P]

};  

 

  • infer: 在 extends 條件陳述句中待推斷的型別變數, 

// 需要獲取到 Promise 型別里蘊含的值

type PromiseVal<P> =

P extends Promise<infer INNER> ? INNER : P;

 

type PStr = Promise<string>;

 

// Test === string

type Test = PromiseVal<PStr>;

 

 

五. 辨別 type & interface 

在各大型別庫中, 會看到形形色色的 type 和 interface . 然而很多人在實際中卻不知道它們的區別. 

 

官網的定義如下: 

 

An interface can be named in an extends or implements clause, but a type alias for an object type literal cannot.

 

An interface can have multiple merged declarations, but a type alias for an object type literal cannot.

 

從一張圖看出它們兩的區別: 

 

 

 

 

建議:  能用 interface 實作,就用 interface , 如果不能才用 type. 

 

 

 

為了更好的閱讀體驗,  《typescrit 最佳實踐》

- 歡迎關注「前端加加」,認真學前端,做個有專業的技術人...

 

轉載請註明出處,本文鏈接:https://www.uj5u.com/qiye/158910.html

標籤:JavaScript

上一篇:vue基礎用法

下一篇:[Vue原始碼]一起來學Vue模板編譯原理(一)-Template生成AST

標籤雲
其他(157675) Python(38076) JavaScript(25376) Java(17977) C(15215) 區塊鏈(8255) C#(7972) AI(7469) 爪哇(7425) MySQL(7132) html(6777) 基礎類(6313) sql(6102) 熊猫(6058) PHP(5869) 数组(5741) R(5409) Linux(5327) 反应(5209) 腳本語言(PerlPython)(5129) 非技術區(4971) Android(4554) 数据框(4311) css(4259) 节点.js(4032) C語言(3288) json(3245) 列表(3129) 扑(3119) C++語言(3117) 安卓(2998) 打字稿(2995) VBA(2789) Java相關(2746) 疑難問題(2699) 细绳(2522) 單片機工控(2479) iOS(2429) ASP.NET(2402) MongoDB(2323) 麻木的(2285) 正则表达式(2254) 字典(2211) 循环(2198) 迅速(2185) 擅长(2169) 镖(2155) 功能(1967) .NET技术(1958) Web開發(1951) python-3.x(1918) HtmlCss(1915) 弹簧靴(1913) C++(1909) xml(1889) PostgreSQL(1872) .NETCore(1853) 谷歌表格(1846) Unity3D(1843) for循环(1842)

熱門瀏覽
  • IEEE1588PTP在數字化變電站時鐘同步方面的應用

    IEEE1588ptp在數字化變電站時鐘同步方面的應用 京準電子科技官微——ahjzsz 一、電力系統時間同步基本概況 隨著對IEC 61850標準研究的不斷深入,國內外學者提出基于IEC61850通信標準體系建設數字化變電站的發展思路。數字化變電站與常規變電站的顯著區別在于程序層傳統的電流/電壓互 ......

    uj5u.com 2020-09-10 03:51:52 more
  • HTTP request smuggling CL.TE

    CL.TE 簡介 前端通過Content-Length處理請求,通過反向代理或者負載均衡將請求轉發到后端,后端Transfer-Encoding優先級較高,以TE處理請求造成安全問題。 檢測 發送如下資料包 POST / HTTP/1.1 Host: ac391f7e1e9af821806e890 ......

    uj5u.com 2020-09-10 03:52:11 more
  • 網路滲透資料大全單——漏洞庫篇

    網路滲透資料大全單——漏洞庫篇漏洞庫 NVD ——美國國家漏洞庫 →http://nvd.nist.gov/。 CERT ——美國國家應急回應中心 →https://www.us-cert.gov/ OSVDB ——開源漏洞庫 →http://osvdb.org Bugtraq ——賽門鐵克 →ht ......

    uj5u.com 2020-09-10 03:52:15 more
  • 京準講述NTP時鐘服務器應用及原理

    京準講述NTP時鐘服務器應用及原理京準講述NTP時鐘服務器應用及原理 安徽京準電子科技官微——ahjzsz 北斗授時原理 授時是指接識訓通過某種方式獲得本地時間與北斗標準時間的鐘差,然后調整本地時鐘使時差控制在一定的精度范圍內。 衛星導航系統通常由三部分組成:導航授時衛星、地面檢測校正維護系統和用戶 ......

    uj5u.com 2020-09-10 03:52:25 more
  • 利用北斗衛星系統設計NTP網路時間服務器

    利用北斗衛星系統設計NTP網路時間服務器 利用北斗衛星系統設計NTP網路時間服務器 安徽京準電子科技官微——ahjzsz 概述 NTP網路時間服務器是一款支持NTP和SNTP網路時間同步協議,高精度、大容量、高品質的高科技時鐘產品。 NTP網路時間服務器設備采用冗余架構設計,高精度時鐘直接來源于北斗 ......

    uj5u.com 2020-09-10 03:52:35 more
  • 詳細解讀電力系統各種對時方式

    詳細解讀電力系統各種對時方式 詳細解讀電力系統各種對時方式 安徽京準電子科技官微——ahjzsz,更多資料請添加VX 衛星同步時鐘是我京準公司開發研制的應用衛星授時時技術的標準時間顯示和發送的裝置,該裝置以M國全球定位系統(GLOBAL POSITIONING SYSTEM,縮寫為GPS)或者我國北 ......

    uj5u.com 2020-09-10 03:52:45 more
  • 如何保證外包團隊接入企業內網安全

    不管企業規模的大小,只要企業想省錢,那么企業的某些服務就一定會采用外包的形式,然而看似美好又經濟的策略,其實也有不好的一面。下面我通過安全的角度來聊聊使用外包團的安全隱患問題。 先看看什么服務會使用外包的,最常見的就是話務/客服這種需要大量重復性、無技術性的服務,或者是一些銷售外包、特殊的職能外包等 ......

    uj5u.com 2020-09-10 03:52:57 more
  • PHP漏洞之【整型數字型SQL注入】

    0x01 什么是SQL注入 SQL是一種注入攻擊,通過前端帶入后端資料庫進行惡意的SQL陳述句查詢。 0x02 SQL整型注入原理 SQL注入一般發生在動態網站URL地址里,當然也會發生在其它地發,如登錄框等等也會存在注入,只要是和資料庫打交道的地方都有可能存在。 如這里http://192.168. ......

    uj5u.com 2020-09-10 03:55:40 more
  • [GXYCTF2019]禁止套娃

    git泄露獲取原始碼 使用GET傳參,引數為exp 經過三層過濾執行 第一層過濾偽協議,第二層過濾帶引數的函式,第三層過濾一些函式 preg_replace('/[a-z,_]+\((?R)?\)/', NULL, $_GET['exp'] (?R)參考當前正則運算式,相當于匹配函式里的引數 因此傳遞 ......

    uj5u.com 2020-09-10 03:56:07 more
  • 等保2.0實施流程

    流程 結論 ......

    uj5u.com 2020-09-10 03:56:16 more
最新发布
  • 使用Django Rest framework搭建Blog

    在前面的Blog例子中我們使用的是GraphQL, 雖然GraphQL的使用處于上升趨勢,但是Rest API還是使用的更廣泛一些. 所以還是決定回到傳統的rest api framework上來, Django rest framework的官網上給了一個很好用的QuickStart, 我參考Qu ......

    uj5u.com 2023-04-20 08:17:54 more
  • 記錄-new Date() 我忍你很久了!

    這里給大家分享我在網上總結出來的一些知識,希望對大家有所幫助 大家平時在開發的時候有沒被new Date()折磨過?就是它的諸多怪異的設定讓你每每用的時候,都可能不小心踩坑。造成程式意外出錯,卻一下子找不到問題出處,那叫一個煩透了…… 下面,我就列舉它的“四宗罪”及應用思考 可惡的四宗罪 1. Sa ......

    uj5u.com 2023-04-20 08:17:47 more
  • 使用Vue.js實作文字跑馬燈效果

    實作文字跑馬燈效果,首先用到 substring()截取 和 setInterval計時器 clearInterval()清除計時器 效果如下: 實作代碼如下: <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta ......

    uj5u.com 2023-04-20 08:12:31 more
  • JavaScript 運算子

    JavaScript 運算子/運算子 在 JavaScript 中,有一些運算子可以使代碼更簡潔、易讀和高效。以下是一些常見的運算子: 1、可選鏈運算子(optional chaining operator) ?.是可選鏈運算子(optional chaining operator)。?. 可選鏈操 ......

    uj5u.com 2023-04-20 08:02:25 more
  • CSS—相對單位rem

    一、概述 rem是一個相對長度單位,它的單位長度取決于根標簽html的字體尺寸。rem即root em的意思,中文翻譯為根em。瀏覽器的文本尺寸一般默認為16px,即默認情況下: 1rem = 16px rem布局原理:根據CSS媒體查詢功能,更改根標簽的字體尺寸,實作rem單位隨螢屏尺寸的變化,如 ......

    uj5u.com 2023-04-20 08:02:21 more
  • 我的第一個NPM包:panghu-planebattle-esm(胖虎飛機大戰)使用說明

    好家伙,我的包終于開發完啦 歡迎使用胖虎的飛機大戰包!! 為你的主頁添加色彩 這是一個有趣的網頁小游戲包,使用canvas和js開發 使用ES6模塊化開發 效果圖如下: (覺得圖片太sb的可以自己改) 代碼已開源!! Git: https://gitee.com/tang-and-han-dynas ......

    uj5u.com 2023-04-20 08:01:50 more
  • 如何在 vue3 中使用 jsx/tsx?

    我們都知道,通常情況下我們使用 vue 大多都是用的 SFC(Signle File Component)單檔案組件模式,即一個組件就是一個檔案,但其實 Vue 也是支持使用 JSX 來撰寫組件的。這里不討論 SFC 和 JSX 的好壞,這個仁者見仁智者見智。本篇文章旨在帶領大家快速了解和使用 Vu ......

    uj5u.com 2023-04-20 08:01:37 more
  • 【Vue2.x原始碼系列06】計算屬性computed原理

    本章目標:計算屬性是如何實作的?計算屬性快取原理以及洋蔥模型的應用?在初始化Vue實體時,我們會給每個計算屬性都創建一個對應watcher,我們稱之為計算屬性watcher ......

    uj5u.com 2023-04-20 08:01:31 more
  • http1.1與http2.0

    一、http是什么 通俗來講,http就是計算機通過網路進行通信的規則,是一個基于請求與回應,無狀態的,應用層協議。常用于TCP/IP協議傳輸資料。目前任何終端之間任何一種通信方式都必須按Http協議進行,否則無法連接。tcp(三次握手,四次揮手)。 請求與回應:客戶端請求、服務端回應資料。 無狀態 ......

    uj5u.com 2023-04-20 08:01:10 more
  • http1.1與http2.0

    一、http是什么 通俗來講,http就是計算機通過網路進行通信的規則,是一個基于請求與回應,無狀態的,應用層協議。常用于TCP/IP協議傳輸資料。目前任何終端之間任何一種通信方式都必須按Http協議進行,否則無法連接。tcp(三次握手,四次揮手)。 請求與回應:客戶端請求、服務端回應資料。 無狀態 ......

    uj5u.com 2023-04-20 08:00:32 more