summaryrefslogtreecommitdiff
path: root/website
diff options
context:
space:
mode:
authorKitson Kelly <me@kitsonkelly.com>2019-02-13 02:08:56 +1100
committerRyan Dahl <ry@tinyclouds.org>2019-02-12 10:08:56 -0500
commita21a5ad2fa4dcbad58fe63c298c69f8607705bf4 (patch)
tree03e0092f46813ffdf84f53ab58f71b8a0276207e /website
parent1e5e091cb074896c7550b1b6f802582f12629048 (diff)
Add Deno global namespace (#1748)
Resolves #1705 This PR adds the Deno APIs as a global namespace named `Deno`. For backwards compatibility, the ability to `import * from "deno"` is preserved. I have tried to convert every test and internal code the references the module to use the namespace instead, but because I didn't break compatibility I am not sure. On the REPL, `deno` no longer exists, replaced only with `Deno` to align with the regular runtime. The runtime type library includes both the namespace and module. This means it duplicates the whole type information. When we remove the functionality from the runtime, it will be a one line change to the library generator to remove the module definition from the type library. I marked a `TODO` in a couple places where to remove the `"deno"` module, but there are additional places I know I didn't mark.
Diffstat (limited to 'website')
-rw-r--r--website/manual.md16
1 files changed, 7 insertions, 9 deletions
diff --git a/website/manual.md b/website/manual.md
index bf5f6d237..96f3b7971 100644
--- a/website/manual.md
+++ b/website/manual.md
@@ -69,8 +69,8 @@ formatters</a>.
### Browser compatibility
The subset of Deno programs which are written completely in JavaScript and do
-not import the special `"deno"` module, ought to also be able to be run in a
-modern web browser without change.
+not use the global `Deno` namespace (or feature test for it), ought to also be
+able to be run in a modern web browser without change.
## Setup
@@ -228,13 +228,11 @@ In this program each command-line argument is assumed to be a filename, the file
is opened, and printed to stdout.
```ts
-import * as deno from "deno";
-
(async () => {
- for (let i = 1; i < deno.args.length; i++) {
- let filename = deno.args[i];
- let file = await deno.open(filename);
- await deno.copy(deno.stdout, file);
+ for (let i = 1; i < Deno.args.length; i++) {
+ let filename = Deno.args[i];
+ let file = await Deno.open(filename);
+ await Deno.copy(Deno.stdout, file);
file.close();
}
})();
@@ -257,7 +255,7 @@ This is an example of a simple server which accepts connections on port 8080,
and returns to the client anything it sends.
```ts
-import { listen, copy } from "deno";
+const { listen, copy } = Deno;
(async () => {
const addr = "0.0.0.0:8080";