deno_import_content

Import arbitrary file content in Deno using module resolution algorithms.

This includes resolving via an import map, authentication using DENO_AUTH_TOKENS, and use of the Deno cache.

The idea is that importText() should act as similar to dynamic import() as possible, but just returning the raw text content instead of an evaluated JS or TS module.

Unfortunately it’s not possible for importText to resolve a relative specifier against the calling module, so they will need to be pre-resolved using import.meta.resolve(). (See the example below, and the tests)

If anyone knows how we could get around this, please raise an issue or better still, a PR.

Permissions

This module makes use of deno_cache to perform fetching, and therefore requires all permissions that it requires. See those docs for full details.

Example

import { importText } from "https://deno.land/x/import_content/mod.ts";

// Fetch the text content of a remote file
const remoteReadme = await importText(
  "https://deno.land/x/import_content/README.md",
);

// Fetch the text content of a local file
const localReadme = await importText(import.meta.resolve("./README.md"));

// Fetch the text content of a file, relying on an import map to resolve to a valid URL
const mappedReadme = await importText("bare/README.md");

Known Bugs

Authentication via DENO_AUTH_TOKENS currently doesn’t work due to a bug in deno_cache. There is a PR to fix this, currently awaiting review.

There is also a bug in deno_cache that requires the --allow-write permission to be given. There is another PR for this too.

Until those issues are solved, this module will depend upon a patched fork of deno_cache imported directly from my own repository.