2020-07-23 10:27:26 -04:00
|
|
|
# Runtime JavaScript Code
|
2020-07-19 13:49:44 -04:00
|
|
|
|
|
|
|
|
This directory contains Deno runtime code written in plain JavaScript.
|
|
|
|
|
|
|
|
|
|
Each file is a plain, old **script**, not ES modules. The reason is that
|
|
|
|
|
snapshotting ES modules is much harder, especially if one needs to manipulate
|
|
|
|
|
global scope (like in case of Deno).
|
|
|
|
|
|
|
|
|
|
Each file is prefixed with a number, telling in which order scripts should be
|
|
|
|
|
loaded into V8 isolate. This is temporary solution and we're striving not to
|
|
|
|
|
require specific order (though it's not 100% obvious if that's feasible).
|
2020-07-22 13:30:59 -04:00
|
|
|
|
|
|
|
|
## Deno Web APIs
|
|
|
|
|
|
|
|
|
|
This directory facilities Web APIs that are available in Deno.
|
|
|
|
|
|
|
|
|
|
Please note, that some implementations might not be completely aligned with
|
|
|
|
|
specification.
|
|
|
|
|
|
|
|
|
|
Some Web APIs are using ops under the hood, eg. `console`, `performance`.
|
|
|
|
|
|
|
|
|
|
## Implemented Web APIs
|
|
|
|
|
|
|
|
|
|
- [Blob](https://developer.mozilla.org/en-US/docs/Web/API/Blob): for
|
|
|
|
|
representing opaque binary data
|
|
|
|
|
- [Console](https://developer.mozilla.org/en-US/docs/Web/API/Console): for
|
|
|
|
|
logging purposes
|
|
|
|
|
- [CustomEvent](https://developer.mozilla.org/en-US/docs/Web/API/CustomEvent),
|
|
|
|
|
[EventTarget](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget)
|
|
|
|
|
and
|
|
|
|
|
[EventListener](https://developer.mozilla.org/en-US/docs/Web/API/EventListener):
|
|
|
|
|
to work with DOM events
|
|
|
|
|
- **Implementation notes:** There is no DOM hierarchy in Deno, so there is no
|
|
|
|
|
tree for Events to bubble/capture through.
|
|
|
|
|
- [fetch](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/fetch),
|
|
|
|
|
[Request](https://developer.mozilla.org/en-US/docs/Web/API/Request),
|
|
|
|
|
[Response](https://developer.mozilla.org/en-US/docs/Web/API/Response),
|
|
|
|
|
[Body](https://developer.mozilla.org/en-US/docs/Web/API/Body) and
|
|
|
|
|
[Headers](https://developer.mozilla.org/en-US/docs/Web/API/Headers): modern
|
|
|
|
|
Promise-based HTTP Request API
|
|
|
|
|
- [FormData](https://developer.mozilla.org/en-US/docs/Web/API/FormData): access
|
|
|
|
|
to a `multipart/form-data` serialization
|
|
|
|
|
- [Performance](https://developer.mozilla.org/en-US/docs/Web/API/Performance):
|
|
|
|
|
retrieving current time with a high precision
|
|
|
|
|
- [setTimeout](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/setTimeout),
|
|
|
|
|
[setInterval](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/setInterval),
|
|
|
|
|
[clearTimeout](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/clearTimeout):
|
|
|
|
|
scheduling callbacks in future and
|
|
|
|
|
[clearInterval](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/clearInterval)
|
|
|
|
|
- [Stream](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API) for
|
|
|
|
|
creating, composing, and consuming streams of data
|
|
|
|
|
- [URL](https://developer.mozilla.org/en-US/docs/Web/API/URL) and
|
|
|
|
|
[URLSearchParams](https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams):
|
|
|
|
|
to construct and parse URLSs
|
|
|
|
|
- [Worker](https://developer.mozilla.org/en-US/docs/Web/API/Worker): executing
|
|
|
|
|
additional code in a separate thread
|
|
|
|
|
- **Implementation notes:** Blob URLs are not supported, object ownership
|
|
|
|
|
cannot be transferred, posted data is serialized to JSON instead of
|
|
|
|
|
[structured cloning](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm).
|
