第一步
此页面包含一些示例,以教您有关Deno的基础知识。
本文档假定您具有JavaScript的某些先决知识,尤其是有关async
/的知识await
。如果您不具备JavaScript的 先决知识,则在尝试从Deno开始之前,可能需要看一看关于JavaScript基础的指南 。
你好,世界
Deno是JavaScript / TypeScript的运行时,它试图与Web兼容并尽可能使用现代功能。
浏览器兼容性意味着Hello World
Deno中的程序与您可以在浏览器中运行的程序相同:
console.log("Welcome to Deno!");
尝试该程序:
deno run https://deno.land/[email protected]/examples/welcome.ts
发出HTTP请求
许多程序使用HTTP请求从Web服务器获取数据。让我们编写一个小程序,该程序读取文件并将其内容打印到终端。
就像在浏览器中一样,您可以使用网络标准 fetch
API进行HTTP调用:
const url = Deno.args[0];
const res = await fetch(url);
const body = new Uint8Array(await res.arrayBuffer());
await Deno.stdout.write(body);
让我们来看一下此应用程序的功能:
- 我们将第一个参数传递给应用程序,并将其存储在
url
常量中。 - 我们向指定的url发出请求,等待响应,然后将其存储在
res
常量中。 - 我们将响应主体解析为
ArrayBuffer
,等待响应,然后将其转换为Uint8Array
并存储在body
常量中。 - 我们将
body
常量的内容写入stdout
。
试试看:
deno run https://deno.land/[email protected]/examples/curl.ts https://example.com
您将看到该程序返回有关网络访问的错误,那么我们做错了什么?您可能从介绍中还记得Deno是默认情况下是安全的运行时。这意味着您需要明确授予程序执行某些“特权”操作的权限,例如访问网络。
使用正确的权限标志再次尝试:
deno run --allow-net=example.com https://deno.land/[email protected]/examples/curl.ts https://example.com
读取文件
Deno还提供了并非来自网络的API。这些都包含在Deno
全局中。您可以在doc.deno.land上找到这些API的文档 。
例如,文件系统API没有Web标准格式,因此Deno提供了自己的API。
在此程序中,每个命令行参数均假定为文件名,该文件被打开并打印到stdout。
const filenames = Deno.args;
for (const filename of filenames) {
const file = await Deno.open(filename);
await Deno.copy(file, Deno.stdout);
file.close();
}
copy()
实际上,这里的功能仅产生必要的内核→用户空间→内核副本。也就是说,将从文件中读取数据的同一内存写入stdout。这说明了Deno中I / O流的一般设计目标。
尝试该程序:
deno run --allow-read https://deno.land/[email protected]/examples/cat.ts /etc/passwd
TCP服务器
这是一个服务器的示例,该服务器在端口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不允许程序未经明确许可而访问网络。要允许访问网络,请使用命令行标志:
deno run --allow-net https://deno.land/[email protected]/examples/echo_server.ts
要对其进行测试,请尝试使用netcat向其发送数据:
$ nc localhost 8080hello worldhello world
像cat.ts
示例一样,copy()
这里的功能也不会进行不必要的内存复制。它从内核接收数据包并将其发送回去,而无需进一步的复杂性。
更多例子
您可以在Examples
本章中找到更多示例,例如HTTP文件服务器。