Deno 中文手册

第一步

这个页面包含一些示例,您可以从中学到 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);

让我们看看它做了什么:

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

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

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

  4. 我们把 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

{{#include ../examples/unix_cat.md:2:}}

TCP 服务§

示例:TCP echo

{{#include ../examples/tcp_echo.md:2:}}

更多示例§

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