language-servers/deno
1
0
Fork 0
mirror of https://github.com/denoland/deno.git synced 2025-09-28 05:04:48 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 3

docs: Deno.emit supports bundling as IIFE (#10242)

Browse source 
Co-authored-by: Luca Casonato <lucacasonato@yahoo.com>
This commit is contained in:
Zeno Zeng 2021-04-21 20:11:01 +08:00 • committed by GitHub
parent a1ac17f9fa
commit 0a699f416b
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 22 additions and 20 deletions
Download patch file Download diff file Expand all files Collapse all files

42
docs/typescript/runtime.md
View file

@ -23,32 +23,34 @@ The emit options are defined in the `Deno` namespace as:
```ts ```ts
interface EmitOptions { interface EmitOptions {
/** Indicate that the source code should be emitted to a single file /** Indicate that the source code should be emitted to a single file
* JavaScript bundle that is an ES module (`"esm"`). */ * JavaScript bundle that is a single ES module (`"esm"`) or a single file
bundle?: "esm"; * self contained script we executes in an immediately invoked function
* when loaded (`"iife"`). */
bundle?: "esm" | "iife";
/** If `true` then the sources will be typed checked, returning any /** If `true` then the sources will be typed checked, returning any
* diagnostic errors in the result. If `false` type checking will be * diagnostic errors in the result. If `false` type checking will be
* skipped. Defaults to `true`. * skipped. Defaults to `true`.
* *
* *Note* by default, only TypeScript will be type checked, just like on * *Note* by default, only TypeScript will be type checked, just like on
* the command line. Use the `compilerOptions` options of `checkJs` to * the command line. Use the `compilerOptions` options of `checkJs` to
* enable type checking of JavaScript. */ * enable type checking of JavaScript. */
check?: boolean; check?: boolean;
/** A set of options that are aligned to TypeScript compiler options that /** A set of options that are aligned to TypeScript compiler options that
* are supported by Deno. */ * are supported by Deno. */
compilerOptions?: CompilerOptions; compilerOptions?: CompilerOptions;
/** An [import-map](https://deno.land/manual/linking_to_external_code/import_maps#import-maps) /** An [import-map](https://deno.land/manual/linking_to_external_code/import_maps#import-maps)
* which will be applied to the imports. */ * which will be applied to the imports. */
importMap?: ImportMap; importMap?: ImportMap;
/** An absolute path to an [import-map](https://deno.land/manual/linking_to_external_code/import_maps#import-maps). /** An absolute path to an [import-map](https://deno.land/manual/linking_to_external_code/import_maps#import-maps).
* Required to be specified if an `importMap` is specified to be able to * Required to be specified if an `importMap` is specified to be able to
* determine resolution of relative paths. If a `importMap` is not * determine resolution of relative paths. If a `importMap` is not
* specified, then it will assumed the file path points to an import map on * specified, then it will assumed the file path points to an import map on
* disk and will be attempted to be loaded based on current runtime * disk and will be attempted to be loaded based on current runtime
* permissions. * permissions.
*/ */
importMapPath?: string; importMapPath?: string;
/** A record of sources to use when doing the emit. If provided, Deno will /** A record of sources to use when doing the emit. If provided, Deno will
* use these sources instead of trying to resolve the modules externally. */ * use these sources instead of trying to resolve the modules externally. */
sources?: Record<string, string>; sources?: Record<string, string>;
} }
``` ```
@ -179,9 +181,9 @@ if (diagnostics.length) {
### Bundling ### Bundling
`Deno.emit()` is also capable of providing output similar to `deno bundle` on `Deno.emit()` is also capable of providing output similar to `deno bundle` on
the command line. This is enabled by setting the _bundle_ option to `"esm"`. the command line. This is enabled by setting the _bundle_ option to `"esm"` or
(Currently Deno only supports bundling as a single file ES module, but there are `"iife"`. Currently Deno supports bundling as a single file ES module (`"esm"`)
plans to add support for an IIFE bundle format as well): or a single file self contained legacy script (`"iife"`).
```ts ```ts
const { files, diagnostics } = await Deno.emit("./mod.ts", { const { files, diagnostics } = await Deno.emit("./mod.ts", {