Deno終於有NPM Support!

筆者兩年前連續寫了兩篇Node.js終結者，分別介紹了Deno 的設計理念，以及Deno比Node.js優勝的地方。 筆者亦在第二篇文中寫了Deno的弱點，主要在於Deno與Node.js龐大的NPM套件庫並不兼容，令現有的Node.js專案難以 轉會。而在11月13日推出的Deno版本1.28，就正正是推出了廣泛之NPM Support! 馬上支援超過130萬的npm套件。

在這篇文章之中，筆者會嘗試用Deno，加上常見的npm套件express及pg套件去建立一個簡單Restful應用。

安裝

要安裝Deno是非常簡單，只需要從官方網站直接運行安裝command。

在Mac或Linux的安裝方法如下:

curl -fsSL https://deno.land/x/install/install.sh | sh

在Windows的安裝方法如下:

irm https://deno.land/install.ps1 | iex

安裝deno 之後，就可以直接運行deno，得到以下結果。

$ deno
Deno 1.28.3
exit using ctrl+d, ctrl+c, or close()
> 

deno本身已支援TypeScript及JavaScript，無須再安裝任何其他軟件。

Express 伺服器

要完成一個簡單expressRestful應用，Deno project 最終只需要幾個檔案。

整個專案簡潔得多，沒有package.json也沒有tsconfig.json!

index.ts

先由index.ts開始，Deno現在可以用npm:XXX的寫法直接使用 npm套件。

import  express  from "npm:express";
import { Express} from 'npm:@types/express'


const app: Express = express()

app.get('/',(req, res)=>{
    res.json({"msg":"Hello World!"})
})

app.listen(8080)

由這段Code可見，在Deno中使用express與node.js中並不相同，因為Node.js使用CommonJS module，而Deno本身就運用較新的標準ES module。 而且Deno並不會將DefinitelyTyped的type@types/express 與本來的express連上關係，變相要開發者自己處理。

要運行這個index.ts，只須直接以deno run。

$ deno run index.ts
⚠️  ┌ Deno requests read access to <CWD>.
   ├ Requested by `Deno.cwd()` API
   ├ Run again with --allow-read to bypass this prompt.
   └ Allow? [y/n] (y = yes, allow; n = no, deny) > 

發生何事呢？因為Deno本身的沙盒式設計，我們需要逐個權限設定。

$ deno run --allow-net --allow-read --allow-env index.ts

不同的flag的意思代表如下,

• --allow-net 代表容許index.ts存取網絡
• --allow-read 代表容許index.ts讀取本機檔案
• --allow-env 代表容許index.ts存取環境變數

然後就成功運行了一個express 伺服器。

deps.ts

不過，根據通常Deno的開發慣例，我們並不會將所有dependencies都放在index.ts。 而是放在一個名為deps.ts的檔案，這個檔案與package.json的作用有些類似，但卻只是一個普通的Typescript file，而非像package.json一樣是每個npm 專案的必備檔案。

我們可以將兩句import抽出來，再放到deps.ts。

export { default as express } from 'npm:express'
export type { Request, Response, Express } from 'npm:@types/express'

在index.ts，就只需直接從deps.ts import 就可以了。

import { express, Express } from "./deps.ts";

const app: Express = express()

app.get('/',(req, res)=>{
    res.json({"msg":"Hello World!"})
})

app.listen(8080)

有需要的話，在deps.ts亦可以直接加上版本，容易控制套件版本。

export { default as express } from 'npm:express@^4.17'
export type { Request, Response, Express } from 'npm:@types/express@^4.17.15'

存取資料庫

為了簡單起見，我們會用非常受歡迎的PostgreSQL資料庫。我們亦可以運用常用的npm 套件pg及dotenv。

export { default as express } from 'npm:express'

export type { Request, Response, Express } from 'npm:@types/express'

export { default as pg } from 'npm:pg'

export type {Client } from 'npm:@types/pg'

export { default as dotenv } from 'npm:dotenv'

這種寫法稱為Re-export，將由npm套件export出來的值再重新命名。

假設我們有一個.env檔案，裏面有連接資料庫需要的username及password。

POSTGRES_DB=deno-test
POSTGRES_USER=tecky
POSTGRES_PASSWORD=tecky

然後就是平常的pg設定寫法。

import { Client, Express, express, pg, dotenv } from "./deps.ts";

dotenv.config()

const app:Express = express()
const config = {
    database: Deno.env.get('POSTGRES_DB'),
    user: Deno.env.get('POSTGRES_USER'),
    password: Deno.env.get('POSTGRES_PASSWORD')
}
const client: Client = new pg.Client(config)

await client.connect()

Deno本身支援top level await，因此直接運用await client.connect()就可以連接資料庫。 當有了連接資料庫的client，剩餘就只是簡單的express Restful應用程式碼。

app.use(express.json())

app.get('/todos', async(req, res)=>{
    const data = (await client.query("SELECT * from todos")).rows
    res.json(data)
})

app.post('/todos',async (req ,res)=>{
    const content = req.body.content
    await client.query("INSERT INTO todos (content) values ($1)",[content])
    res.json("Hello World")
})

app.listen(8080, ()=>{
    console.log("Listening at http://localhost:8080")
})

再用deno run重新運行，不論GET /todos及POST /todos都可以成功運行了!

這段程式碼，已經開源在Github Deno NPM Example 之上

局限性

你可能讀到這裏，覺得Deno實在太方便了! 既不需要用到npm，又不需要用到package.json及tsconfig.json，是否想馬上轉會呢? 筆者在此潑個小小的冷水，Deno在套件上確實還是有一些局限:

例如Deno在資料庫存取上的套件比較欠缺，欠缺像knex一樣可以跨資料庫的Database Migration套件庫，運用knex的npm套件庫是一個選擇，但現在時間尚早，網上資源亦比較欠奉。 大家亦可以選擇運用一些支援Deno的套件，例如Postgres.js及nessie，但就可能需要找尋一下了。

總結

Deno 1.28加入了npm support，確實令Deno的實用性大大增強，可以活用有數百萬套件的npm套件庫。 要將現有Node.js專案，改為Deno專案，難度亦已降低很多。實際是想轉會的Node.js用戶之喜訊。 展望未來，運用Deno的開發者會以npm套件為主，deno本身的套件為輔，才是最有效的做法。