第一步

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

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

Hello World

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

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

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

尝试一下:

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

发出一个 HTTP 请求

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

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

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

让我们看看它做了什么:

  1. 我们取得了第一个命令行参数,存储到变量 url

  2. 我们向指定的地址发出请求,等待响应,然后存储到变量 res

  3. 我们把响应体解析为一个 ArrayBuffer,等待接收完毕,将其转换为 Uint8Array,最后存储到变量 body

  4. 我们把 body 的内容写入标准输出流 stdout

尝试一下:

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

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

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

  1. 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

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

  1. const filenames = Deno.args;
  2. for (const filename of filenames) {
  3. const file = await Deno.open(filename);
  4. await Deno.copy(file, Deno.stdout);
  5. file.close();
  6. }

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

尝试一下:

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

TCP 服务

示例:TCP echo

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

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

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

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

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

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

尝试用 netcat 向它发送数据。

  1. $ nc localhost 8080
  2. hello world
  3. hello world

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

更多示例

您可以在 示例 一章找到更多示例。