- 译者:@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 下绝大多数可以上手的库: