summaryrefslogtreecommitdiff
path: root/docs/linking_to_external_code
diff options
context:
space:
mode:
Diffstat (limited to 'docs/linking_to_external_code')
-rw-r--r--docs/linking_to_external_code/import_maps.md42
-rw-r--r--docs/linking_to_external_code/integrity_checking.md5
-rw-r--r--docs/linking_to_external_code/proxies.md9
-rw-r--r--docs/linking_to_external_code/reloading_modules.md22
4 files changed, 78 insertions, 0 deletions
diff --git a/docs/linking_to_external_code/import_maps.md b/docs/linking_to_external_code/import_maps.md
new file mode 100644
index 000000000..7ec963d39
--- /dev/null
+++ b/docs/linking_to_external_code/import_maps.md
@@ -0,0 +1,42 @@
+## Import maps
+
+> This is an unstable feature. Learn more about
+> [unstable features](../../runtime/unstable).
+
+Deno supports [import maps](https://github.com/WICG/import-maps).
+
+You can use import map with the `--importmap=<FILE>` CLI flag.
+
+Current limitations:
+
+- single import map
+- no fallback URLs
+- Deno does not support `std:` namespace
+- supports only `file:`, `http:` and `https:` schemes
+
+Example:
+
+```js
+// import_map.json
+
+{
+ "imports": {
+ "http/": "https://deno.land/std/http/"
+ }
+}
+```
+
+```ts
+// hello_server.ts
+
+import { serve } from "http/server.ts";
+
+const body = new TextEncoder().encode("Hello World\n");
+for await (const req of serve(":8000")) {
+ req.respond({ body });
+}
+```
+
+```shell
+$ deno run --importmap=import_map.json hello_server.ts
+```
diff --git a/docs/linking_to_external_code/integrity_checking.md b/docs/linking_to_external_code/integrity_checking.md
new file mode 100644
index 000000000..820ea1d2b
--- /dev/null
+++ b/docs/linking_to_external_code/integrity_checking.md
@@ -0,0 +1,5 @@
+## Integrity checking & lock files
+
+Deno can store and check module subresource integrity for modules using a small
+JSON file. Use the `--lock=lock.json` to enable and specify lock file checking.
+To update or create a lock use `--lock=lock.json --lock-write`.
diff --git a/docs/linking_to_external_code/proxies.md b/docs/linking_to_external_code/proxies.md
new file mode 100644
index 000000000..11c66a5a9
--- /dev/null
+++ b/docs/linking_to_external_code/proxies.md
@@ -0,0 +1,9 @@
+## Proxies
+
+Deno supports proxies for module downloads and `fetch` API.
+
+Proxy configuration is read from environmental variables: `HTTP_PROXY` and
+`HTTPS_PROXY`.
+
+In case of Windows if environmental variables are not found Deno falls back to
+reading proxies from registry.
diff --git a/docs/linking_to_external_code/reloading_modules.md b/docs/linking_to_external_code/reloading_modules.md
new file mode 100644
index 000000000..6589ea6bc
--- /dev/null
+++ b/docs/linking_to_external_code/reloading_modules.md
@@ -0,0 +1,22 @@
+## Reloading modules
+
+You can invalidate your local `DENO_DIR` cache using the `--reload` flag. It's
+usage is described below:
+
+To reload everything
+
+`--reload`
+
+Sometimes we want to upgrade only some modules. You can control it by passing an
+argument to a `--reload` flag.
+
+To reload all standard modules
+
+`--reload=https://deno.land/std`
+
+To reload specific modules (in this example - colors and file system utils) use
+a comma to separate URLs
+
+`--reload=https://deno.land/std/fs/utils.ts,https://deno.land/std/fmt/colors.ts`
+
+<!-- Should this be part of examples? --