Skip to content

docs: text imports are stable in 2.8 (bytes still require flag)#3144

Merged
bartlomieju merged 2 commits into
2.8from
docs/2.8-text-imports-stable
May 20, 2026
Merged

docs: text imports are stable in 2.8 (bytes still require flag)#3144
bartlomieju merged 2 commits into
2.8from
docs/2.8-text-imports-stable

Conversation

@bartlomieju
Copy link
Copy Markdown
Member

In Deno 2.8, `with { type: "text" }` imports are stable and no longer require `--unstable-raw-imports`. Binary `with { type: "bytes" }` imports remain experimental and still need the flag.

  • `runtime/fundamentals/modules.md`: split the Import attributes admonition so it documents the new state. The `text` example moves above the admonition; the `bytes` example stays after it.
  • `examples/scripts/importing_text.ts`: drop `--unstable-raw-imports` from `@run` and the prose; move from `@group Unstable APIs` to `@group Basics`; mention that `bytes` imports still require the flag.

Left `examples/scripts/importing_bytes.ts` unchanged.

- modules.md: split the Import attributes admonition so it reflects the
  2.8 split (text stable, bytes still experimental).
- importing_text.ts example: drop the --unstable-raw-imports flag from
  @run and the description; clarify that bytes imports still require it;
  move from Unstable APIs to Basics group.
@bartlomieju bartlomieju merged commit f6b3245 into 2.8 May 20, 2026
1 check was pending
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant