diff options
Diffstat (limited to 'docs/linking_to_external_code')
-rw-r--r-- | docs/linking_to_external_code/import_maps.md | 42 | ||||
-rw-r--r-- | docs/linking_to_external_code/integrity_checking.md | 5 | ||||
-rw-r--r-- | docs/linking_to_external_code/proxies.md | 9 | ||||
-rw-r--r-- | docs/linking_to_external_code/reloading_modules.md | 22 |
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? -- |