deno.com
在当前页面

文件系统 API

Deno Deploy 支持 Deno 中可用的部分文件系统 API。这些文件系统 API 可以访问部署中的静态文件。静态文件例如：

  • 如果您通过 GitHub 集成部署，则 GitHub 仓库中的文件。
  • 在 playground 部署中的入口文件。

可用的 API 包括：

Deno.cwd Jump to heading

Deno.cwd() 返回部署的当前工作目录。它位于部署根目录的根目录下。例如，如果您通过 GitHub 集成部署，则当前工作目录是 GitHub 仓库的根目录。

Deno.readDir Jump to heading

Deno.readDir() 允许您列出目录的内容。

该函数与 Deno 完全兼容。

function Deno.readDir(path: string | URL): AsyncIterable<DirEntry>

路径可以是相对路径或绝对路径。也可以是 file: URL。

示例 Jump to heading

此示例列出一个目录的内容，并将此列表作为 JSON 对象返回在响应体中。

async function handler(_req) {
  // 列出位于仓库根目录下的 `blog` 目录中的帖子。
  const posts = [];
  for await (const post of Deno.readDir(`./blog`)) {
    posts.push(post);
  }

  // 返回 JSON。
  return new Response(JSON.stringify(posts, null, 2), {
    headers: {
      "content-type": "application/json",
    },
  });
}

Deno.serve(handler);

Deno.readFile Jump to heading

Deno.readFile() 允许您将文件完全读入内存。

该函数定义与 Deno 类似，但目前不支持 ReadFileOptions。未来将添加支持。

function Deno.readFile(path: string | URL): Promise<Uint8Array>

路径可以是相对路径或绝对路径。也可以是 file: URL。

示例 Jump to heading

此示例将文件内容作为字节数组读入内存，然后将其作为响应体返回。

async function handler(_req) {
  // 让我们读取仓库根目录下的 README.md 文件，以探索可用的方法。

  // 相对路径相对于仓库的根目录
  const readmeRelative = await Deno.readFile("./README.md");
  // 绝对路径。
  // 仓库的内容在 Deno.cwd() 下可用。
  const readmeAbsolute = await Deno.readFile(`${Deno.cwd()}/README.md`);
  // 也支持文件 URL。
  const readmeFileUrl = await Deno.readFile(
    new URL(`file://${Deno.cwd()}/README.md`),
  );

  // 将 Uint8Array 解码为字符串。
  const readme = new TextDecoder().decode(readmeRelative);
  return new Response(readme);
}

Deno.serve(handler);

注意：要使用此功能，您必须将 GitHub 仓库链接到您的项目。

Deno Deploy 支持 Deno.readFile API 从文件系统中读取静态资源。这对于提供静态资源（如图片、样式表和 JavaScript 文件）非常有用。本指南演示了如何使用此功能。

假设 GitHub 仓库中有以下文件结构：

├── mod.ts
└── style.css

mod.ts 的内容：

async function handleRequest(request: Request): Promise<Response> {
  const { pathname } = new URL(request.url);

  // 服务器的工作原理如下：
  // 1. 请求特定资源。
  // 2. 我们从文件系统中读取资源。
  // 3. 我们将资源发送回客户端。

  // 检查请求是否为 style.css。
  if (pathname.startsWith("/style.css")) {
    // 从文件系统中读取 style.css 文件。
    const file = await Deno.readFile("./style.css");
    // 使用 style.css 文件响应请求。
    return new Response(file, {
      headers: {
        "content-type": "text/css",
      },
    });
  }

  return new Response(
    `<html>
      <head>
        <link rel="stylesheet" href="style.css" />
      </head>
      <body>
        <h1>示例</h1>
      </body>
    </html>`,
    {
      headers: {
        "content-type": "text/html; charset=utf-8",
      },
    },
  );
}

Deno.serve(handleRequest);

提供给 Deno.readFile API 的路径相对于仓库的根目录。您也可以指定绝对路径，如果它们在 Deno.cwd 内。

Deno.readTextFile Jump to heading

此函数与 Deno.readFile 类似，只是它将文件内容解码为 UTF-8 字符串。

function Deno.readTextFile(path: string | URL): Promise<string>

示例 Jump to heading

此示例将文本文件读入内存，并将内容作为响应体返回。

async function handler(_req) {
  const readme = await Deno.readTextFile("./README.md");
  return new Response(readme);
}

Deno.serve(handler);

Deno.open Jump to heading

Deno.open() 允许您打开文件，返回一个文件句柄。然后可以使用此文件句柄读取文件内容。有关文件句柄上可用方法的信息，请参见 Deno.File。

该函数定义与 Deno 类似，但目前不支持 OpenOptions。未来将添加支持。

function Deno.open(path: string | URL): Promise<Deno.File>

路径可以是相对路径或绝对路径。也可以是 file: URL。

示例 Jump to heading

此示例打开一个文件，然后将内容流式传输为响应体。

async function handler(_req) {
  // 打开仓库根目录下的 README.md 文件。
  const file = await Deno.open("./README.md");

  // 使用 `readable` 属性，它是一个 `ReadableStream`。这将在响应发送完成后自动关闭文件句柄。
  return new Response(file.readable);
}

Deno.serve(handler);

Note

当您如下所示迭代文件流时，文件描述符将在迭代结束时自动关闭。无需手动关闭文件描述符：const iterator = fd.readable[Symbol.asyncIterator]();

Deno.File Jump to heading

Deno.File 是从 Deno.open() 返回的文件句柄。它可用于使用 read() 方法读取文件的块。可以使用 close() 方法关闭文件句柄。

该接口与 Deno 类似，但不支持写入文件或查找。未来将添加对后者的支持。

class File {
  readonly rid: number;

  close(): void;
  read(p: Uint8Array): Promise<number | null>;
}

路径可以是相对路径或绝对路径。也可以是 file: URL。

Deno.File#read() Jump to heading

read 方法用于读取文件的块。应传递一个缓冲区以读取数据。它返回读取的字节数，如果到达文件末尾，则返回 null。

function read(p: Uint8Array): Promise<number | null>;

Deno.File#close() Jump to heading

close 方法用于关闭文件句柄。关闭句柄将中断所有正在进行的读取。

function close(): void;

Deno.stat Jump to heading

Deno.stat() 读取文件系统条目的元数据。它返回一个 Deno.FileInfo 对象。符号链接会被跟踪。

该函数定义与 Deno 相同。它不返回修改时间、访问时间或创建时间值。

function Deno.stat(path: string | URL): Promise<Deno.FileInfo>

路径可以是相对路径或绝对路径。也可以是 file: URL。

示例 Jump to heading

此示例获取文件的大小，并将结果作为响应体返回。

async function handler(_req) {
  // 获取仓库根目录下 README.md 的文件信息。
  const info = await Deno.stat("./README.md");

  // 获取文件的大小（以字节为单位）。
  const size = info.size;

  return new Response(`README.md 的大小为 ${size} 字节`);
}

Deno.serve(handler);

Deno.lstat Jump to heading

Deno.lstat() 与 Deno.stat() 类似，但它不跟踪符号链接。

该函数定义与 Deno 相同。它不返回修改时间、访问时间或创建时间值。

function Deno.lstat(path: string | URL): Promise<Deno.FileInfo>

路径可以是相对路径或绝对路径。也可以是 file: URL。

Deno.FileInfo Jump to heading

Deno.FileInfo 接口用于表示文件系统条目的元数据。它由 Deno.stat() 和 Deno.lstat() 函数返回。它可以表示文件、目录或符号链接。

在 Deno Deploy 中，只有文件类型和大小属性可用。大小属性的行为与 Linux 上的行为相同。

interface FileInfo {
  isDirectory: boolean;
  isFile: boolean;
  isSymlink: boolean;
  size: number;
}

Deno.realPath Jump to heading

Deno.realPath() 返回跟踪符号链接后文件的解析绝对路径。

该函数定义与 Deno 相同。

function Deno.realPath(path: string | URL): Promise<string>

路径可以是相对路径或绝对路径。也可以是 file: URL。

示例 Jump to heading

此示例调用 Deno.realPath() 获取仓库根目录下文件的绝对路径。结果作为响应体返回。

async function handler(_req) {
  const path = await Deno.realPath("./README.md");

  return new Response(`./README.md 的完全解析路径为 ${path}`);
}

Deno.serve(handler);

Deno.readLink() 返回符号链接的目标路径。

该函数定义与 Deno 相同。

function Deno.readLink(path: string | URL): Promise<string>

路径可以是相对路径或绝对路径。也可以是 file: URL。

示例 Jump to heading

此示例调用 Deno.readLink() 获取仓库根目录下文件的绝对路径。结果作为响应体返回。

async function handler(_req) {
  const path = await Deno.readLink("./my_symlink");

  return new Response(`./my_symlink 的目标路径为 ${path}`);
}

Deno.serve(handler);

你找到需要的内容了吗？

编辑此页面
隐私政策