• 译者:@hylerrix, @YunKou
  • 备注:本文已获原作者授权,同时本文会收录在《Deno 钻研之术》的翻译篇中。
  • 备注:本文独立争取授权与翻译的同时,发现 InfoQ 等平台也独立授权翻译,可以作为对比。看来翻译的文章不能积压,要不也会错失风口。

上周我发表了一篇关于 Deno 的文章:《Deno + WebSockets 打造聊天室应用》。在那之后,有很多困惑接踵而至——其中大部分都在思考如何在全新的 Deno 生态中来做 Node.js 上常做的工作。

所以我尝试整理一些 Node.js 中常见库在 Deno 下的相关解决方案。在这里我得强调,很多 Node.js 的模块都可以重用,并且没有必要为每个库都重新造一遍轮子。你可以访问 pika.dev 来寻找在 Deno 中可以直接使用的 ES 模块。

译者注:《Deno + WebSockets 打造聊天室应用》已经翻译并收录;pika.dev 用来在 Npm 上寻找符合现代 ESM 标准的软件包(更快、更小)。

本文的目录如下:

  • Electron
  • Forever / PM2
  • Express / Koa
  • MongoDB
  • PostgresSQL
  • MySQL / MariaDB
  • Redis
  • Nodemon
  • Jest、Jasmine、Ava...
  • Webpack、Parcel、Rollup...
  • Prettier
  • NPM Scripts
  • Nvm
  • Npx
  • 在 Docker 上运行
  • 作为 Lambda 运行
  • 小结

Electron

Chromium

答案是如今的 Electron 还远远不能运行在 Deno 上,我们必须寻找其它的解决方案。自从 Deno 选择用 Rust 语言构建其内核后,我们可以使用 Rust 生态上的 Web View @Bosop/web-view 来在 Deno 上运行桌面应用。

import { WebView } from "https://deno.land/x/webview/mod.ts";

const sharedOptions = {
  width: 400,
  height: 200,
  resizable: true,
  debug: true,
  frameless: false,
};

const webview1 = new WebView({
  title: "Multiple deno_webview example",
  url: `data:text/html,
    <html>
    <body>
      <h1>1</h1>
    </body>
    </html>
    `,
  ...sharedOptions,
});

const webview2 = new WebView({
  title: "Multiple deno_webview example",
  url: `data:text/html,
    <html>
    <body>
      <h1>2</h1>
    </body>
    </html>
    `,
  ...sharedOptions,
});

await Promise.all([webview1.run(), webview2.run()]);

Forever / PM2

Forever 和 PM2 是用来守护指定脚本其进程的两个 CLI 工具。PM2 相比 Forever 来说功能更为完善,相比还能同时作为负载均衡器。在 Node.js 中这两个工具都很有用,我们可以在 Deno 中也使用它们吗?

Forever 专为 Node.js 创造,就不用考虑了;而 PM2 可以运行 Node.js 之外的的脚本语言,因此我们可以让 PM2 和 Deno 搭配起来。

app.sh
#!/bin/bash
deno run -A myCode.ts

保存后在当前目录执行(请确保 pm2 已成功安装):

pm2 start ./app.sh

Express / Koa

Express 和 Koa 以其强大的路由系统和友好的 HTTP 工具库(重定向、缓存等)而闻名于 Node.js 社区。我们可以在 Deno 中使用它们吗?答案是不能...但也有一些替代方案。

HTTP(标准库)

ExpressKoa
import { ServerRequest } from "https://deno.land/std/http/server.ts";
import { getCookies } from "https://deno.land/std/http/cookie.ts";

let request = new ServerRequest();
request.headers = new Headers();
request.headers.set("Cookie", "full=of; tasty=chocolate");

const cookies = getCookies(request);
console.log("cookies:", cookies);

但由于 Deno 内置的 HTTP 标准库其声明路由的方式并不那么吸引人,我们来看看其它的解决方案,如下。

Oak (第三方库)

受 Koa 启发,这是目前最优雅的解决方案之一:https://github.com/oakserver/oak。

import { Application,  } from "https://deno.land/x/oak/mod.ts";

const app = new Application();

app.use((ctx) => {
  ctx.response.body = "Hello World!";
});

await app.listen({ port: 8000 });

Abc (第三方库)

import { Application } from "https://deno.land/x/abc/mod.ts";

const app = new Application();

app.static("/static", "assets");

app.get("/hello", (c) => "Hello!")
  .start({ port: 8080 });

Deno-Express(第三方库)

也许是最类似于 Express Framework 的替代品:https://github.com/NMathar/deno-express。

import * as exp from "https://raw.githubusercontent.com/NMathar/deno-express/master/mod.ts";

const port = 3000;
const app = new exp.App();

app.use(exp.static_("./public"));
app.use(exp.bodyParser.json());

app.get("/api/todos", async (req, res) => {
  await res.json([{ name: "Buy some milk" }]);
});

const server = await app.listen(port);
console.log(`app listening on port ${server.port}`);

MongoDB

MEANMERN
译者注:MEAN = MongoDB(数据库) + Express(后端) + Angular(前端) + Node.js(运行时);MERN 同左,但其中的 R 代表 React。如上技术栈都对 JavaScript 语言极其友好。

因此,我们可以让 Deno 和 MongoDB 搭配起来,比如使用这个模块:https://github.com/manyuanrong/deno_mongo。

import { init, MongoClient } from "https://deno.land/x/mongo@v0.6.0/mod.ts";

// Initialize the plugin
await init();

const client = new MongoClient();
client.connectWithUri("mongodb://localhost:27017");

const db = client.database("test");
const users = db.collection("users");

// insert
const insertId = await users.insertOne({
  username: "user1",
  password: "pass1"
});

// findOne
const user1 = await users.findOne({ _id: insertId });

// find
const users = await users.find({ username: { $ne: null } });

// aggregation
const docs = await users.aggregation([
  { $match: { username: "many" } },
  { $group: { _id: "$username", total: { $sum: 1 } } }
]);

// updateOne
const { matchedCount, modifiedCount, upsertedId } = await users.updateOne(
  username: { $ne: null },
  { $set: { username: "USERNAME" } }
);

// deleteOne
const deleteCount = await users.deleteOne({ _id: insertId });

PostgresSQL

与 MongoDB 一样,PostgresSQL 也有一个 Deno 生态库:https://github.com/buildondata/deno-postgres。

import { Client } from "https://deno.land/x/postgres/mod.ts";

const client = new Client({
  user: "user",
  database: "test",
  hostname: "localhost",
  port: 5432
});
await client.connect();
const result = await client.query("SELECT * FROM people;");
console.log(result.rows);
await client.end();

MySQL / MariaDB

MongoDBPostgresSQL
import { Client } from "https://deno.land/x/mysql/mod.ts";

const client = await new Client().connect({
  hostname: "127.0.0.1",
  username: "root",
  db: "dbname",
  poolSize: 3, // connection limit
  password: "password",
});

let result = await client.execute(`INSERT INTO users(name) values(?)`, [
  "aralroca",
]);
console.log(result);
// { affectedRows: 1, lastInsertId: 1 }

Redis

Redis 是著名的缓存数据库之一,Deno 下也有相关库:https://github.com/keroxp/deno-redis。

import { connect } from "https://denopkg.com/keroxp/deno-redis/mod.ts";

const redis = await connect({
  hostname: "127.0.0.1",
  port: 6379
});
const ok = await redis.set("example", "this is an example");
const example = await redis.get("example");

Nodemon

node

抱歉,不能...但仍然有另一种选择:Denon:https://github.com/eliassjogreen/denon。

deno runDenon
➜ denon server.ts

Jest、Jasmine、Ava...

Node.jsNode.js
std
import { assertStrictEq } from 'https://deno.land/std/testing/asserts.ts'

Deno.test('My first test', async () => {
  assertStrictEq(true, false)
})

运行测试:

➜  deno test

Webpack、Parcel、Rollup...

ESmodulesTypeScript

然而,可能你会想,如果给定一个文件目录,我们是否可以将其统一打包在有一个 JavaScript 文件里,并让其能直接在 Web 上以模块的形式运行。

答案是完全可行,我们可以通过 Deno 的 CLI 来实现。因此,不需要第三方的打包工具。

➜ deno bundle myLib.ts myLib.bundle.js

现在可以将其加载到浏览器中了:

<script type="module">
  import * as myLib from "myLib.bundle.js";
</script>

Prettier

在过去的几年中,Prettier 在 JavaScript 生态中已广为人知,因为有了它,我们不必担心格式化文件。

事实上 Prettier 也可以在 Deno 上使用,但是没有必要:因为 Deno 有自己内置的格式化程序。

您可以使用以下命令格式化文件:

➜  deno fmt

NPM Scripts

package.jsonpackage.json
makefilemake

您可以使用脚本定义文件:

# scripts.yaml
scripts:
  start: deno run --allow-net server.ts
  test: deno test --allow-net server_test.ts

并执行:

➜  vr run <SCRIPT>
Velociraptor

Nvm

CLI
nvmdvm
➜  dvm use 1.0.0

Npx

deno install [https://url-of-module.ts](https://url-of-module.ts)

就像我们通过命令行运行项目一样,只不过这里把我们使用 URL 模块名的代替了文件名:

➜  deno run https://deno.land/std/examples/welcome.ts
package.json

在 Docker 上运行

DockerDockerfile
FROM hayd/alpine-deno:1.0.0

EXPOSE 1993  # Port.

WORKDIR /app

USER deno

COPY deps.ts .
RUN deno cache deps.ts # Cache the deps

ADD . .
RUN deno cache main.ts # main entrypoint.

CMD ["--allow-net", "main.ts"]

构建并运行它:

➜  docker build -t app . && docker run -it --init -p 1993:1993 app

作为 Lambda 运行

lambdaDeno STD
import {
  APIGatewayProxyEvent,
  APIGatewayProxyResult,
  Context
} from "https://deno.land/x/lambda/mod.ts";

export async function handler(
  event: APIGatewayProxyEvent,
  context: Context
): Promise<APIGatewayProxyResult> {
  return {
    body: `Welcome to deno ${Deno.version.deno}  `,
    headers: { "content-type": "text/html;charset=utf8" },
    statusCode: 200
  };
}

参考:

小结

本文中,我难免会遗漏一些 Node 库如何在 Deno 使用的解决方案。如果有什么更多的地方需要我解释,欢迎告诉我。希望这篇文章能帮助你打破快速入手 Deno 应用开发的僵局。

这里可以探索 Deno 下绝大多数可以上手的库: