2. 入门 - 2.3. 第一步 - 《Deno v1.0 中文手册》

第一步

第一步

这个页面包含一些示例，您可以从中学到 Deno 的基本概念。

我们假设您已经对 JavaScript 有过预先的了解，特别是 async/await。如果您没有了解过 JavaScript，您可能需要先阅读这个指南：JavaScript.

Hello World

Deno 是一个 JavaScript 和 TypeScript 的运行时，并尝试与浏览器兼容并使用现代的功能 (features)。

由于 Deno 具有浏览器兼容性，Hello World 程序与浏览器里的没有区别。

console.log("Welcome to Deno 🦕");

尝试一下：

deno run https://deno.land/std/examples/welcome.ts

发出一个 HTTP 请求

通过 HTTP 请求从服务器获取数据是一件很常见的事。让我们编写一个简单的程序来获取文件并打印到终端。

就像浏览器一样，您可以使用 web 标准的 fetch API 来发出请求。

const url = Deno.args[0];
const res = await fetch(url);
const body = new Uint8Array(await res.arrayBuffer());
await Deno.stdout.write(body);

让我们看看它做了什么：

我们取得了第一个命令行参数，存储到变量 url。
我们向指定的地址发出请求，等待响应，然后存储到变量 res。
我们把响应体解析为一个 ArrayBuffer，等待接收完毕，将其转换为 Uint8Array，最后存储到变量 body。
我们把 body 的内容写入标准输出流 stdout。

尝试一下：

deno run https://deno.land/std/examples/curl.ts https://example.com

这个程序将会返回一个关于网络权限的错误，我们做错了什么？您可能会想起来，Deno 默认用安全环境执行代码。这意味着您需要显式赋予程序权限，允许它进行一些特权操作，比如网络访问。

用正确的权限选项再试一次：

deno run --allow-net=example.com https://deno.land/std/examples/curl.ts https://example.com

读取一个文件

Deno 也提供内置的 API，它们都位于全局变量 Deno 中。您可以在此找到相关文档：doc.deno.land。

文件系统 API 没有 web 标准形式，所以 Deno 提供了内置的 API。

示例：Unix cat

在这个程序中，每个命令行参数都是一个文件名，参数对应的文件将被依次打开，打印到标准输出流。

const filenames = Deno.args;
for (const filename of filenames) {
  const file = await Deno.open(filename);
  await Deno.copy(file, Deno.stdout);
  file.close();
}

除了内核到用户空间再到内核的必要拷贝，这里的 copy() 函数不会产生额外的昂贵操作，从文件中读到的数据会原样写入标准输出流。这反映了 Deno I/O 流的通用设计目标。

尝试一下：

deno run --allow-read https://deno.land/std/examples/cat.ts /etc/passwd

TCP 服务

示例：TCP echo

这个示例是一个 TCP echo 服务，接收 8080 端口的连接，把接收到的任何数据返回给客户端。

const hostname = "0.0.0.0";
const port = 8080;
const listener = Deno.listen({ hostname, port });
console.log(`Listening on ${hostname}:${port}`);
for await (const conn of listener) {
  Deno.copy(conn, conn);
}

当这个程序启动时，它会抛出一个没有网络权限的错误。

$ deno run https://deno.land/std/examples/echo_server.ts
error: Uncaught PermissionDenied: network access to "0.0.0.0:8080", run again with the --allow-net flag
► $deno$/dispatch_json.ts:40:11
    at DenoError ($deno$/errors.ts:20:5)
    ...

为了安全，Deno 不允许程序访问网络，除非显式赋予权限。使用一个命令行选项来允许程序访问网络：

deno run --allow-net https://deno.land/std/examples/echo_server.ts

尝试用 netcat 向它发送数据。

$ nc localhost 8080
hello world
hello world

像示例 cat.ts 一样，copy() 函数不会产生不必要的内存拷贝。它从内核接收数据包，然后发送回去，就这么简单。

2.3. 第一步

第一步

Hello World

发出一个 HTTP 请求

读取一个文件

TCP 服务

更多示例