1
0
Fork 0
mirror of https://github.com/denoland/deno.git synced 2024-12-22 23:34:47 -05:00
A modern runtime for JavaScript and TypeScript. https://deno.com/
Find a file
2018-08-17 18:50:37 -04:00
build_extra Upgrade Rust Flatbuffers 2018-08-16 08:40:11 -04:00
js Command line flag parsing (#524) 2018-08-17 16:34:30 -04:00
src Use snake-case for cmd_id. 2018-08-17 18:50:37 -04:00
tests chore: format files in tests/ 2018-08-17 12:43:21 -04:00
third_party@cd487d4d50 Upgrade fbs to latest. 2018-08-17 18:50:37 -04:00
tools Add yarn.lock to third_party 2018-08-17 15:11:32 -04:00
.appveyor.yml appveyor: automatically remove stale build outputs from cache 2018-08-17 21:25:12 +02:00
.gitattributes Create .gitattributes 2018-07-13 19:25:52 +02:00
.gitignore Remove yarn.lock 2018-08-08 10:08:18 -07:00
.gitmodules Update repo links to denoland. 2018-08-02 23:12:49 -04:00
.gn chore: introduce rust_treat_warnings_as_errors build arg 2018-08-14 10:51:01 -04:00
.prettierignore Remove msg_generated hack (#409) 2018-07-25 23:07:50 -04:00
.travis.yml Travis: publish from CI (#501) 2018-08-17 11:54:36 -04:00
build move v8 to third_party/v8 (#322) 2018-07-03 10:15:32 +02:00
BUILD.gn Remove dead code: src/flatbuffer_builder.cc 2018-08-16 08:40:11 -04:00
build_overrides move v8 to third_party/v8 (#322) 2018-07-03 10:15:32 +02:00
buildtools move v8 to third_party/v8 (#322) 2018-07-03 10:15:32 +02:00
Cargo.toml Add 'tokio' and dependencies 2018-08-09 01:13:11 +02:00
gclient_config.py Upgrade fbs to latest. 2018-08-17 18:50:37 -04:00
LICENSE Update LICENSE 2018-06-01 12:13:26 +02:00
node_modules chore: reorganize symlinks 2018-07-06 01:57:32 -04:00
package.json Use unit_tests for readFileSync testing. 2018-08-11 09:02:07 -07:00
README.md Fix badges 2018-08-03 10:28:02 -04:00
Roadmap.md Replace protobuf with flatbuffer 2018-08-03 12:15:52 -04:00
rollup.config.js Generate declarations 2018-08-08 04:17:46 -07:00
testing move v8 to third_party/v8 (#322) 2018-07-03 10:15:32 +02:00
tsconfig.json Use typescript strict mode (#505) 2018-08-15 12:40:30 -04:00
tslint.json Import ts file from prototype without change 2018-07-06 12:22:11 -04:00

deno

Linux Windows
Travis Appveyor

A secure TypeScript runtime built on V8

  • Supports TypeScript 3.0.1 out of the box. Uses V8 6.9.297. That is, it's very modern JavaScript.

  • No package.json. No npm. Not explicitly compatible with Node.

  • Imports reference source code URLs only.

    import { test } from "https://unpkg.com/deno_testing@0.0.5/testing.ts"
    import { log } from "./util.ts"
    

    Remote code is fetched and cached on first execution, and never updated until the code is run with the --reload flag. (So, this will still work on an airplane. See ~/.deno/src for details on the cache.)

  • File system and network access can be controlled in order to run sandboxed code. Defaults to read-only file system access and no network access. Access between V8 (unprivileged) and Rust (privileged) is only done via serialized messages defined in this flatbuffer. This makes it easy to audit. To enable write access explicitly use --allow-write and --allow-net for network access.

  • Single executable:

    > ls -lh out/release/deno
    -rwxr-xr-x  1 rld  staff    48M Aug  2 13:24 out/release/deno
    > otool -L out/release/deno
    out/release/deno:
    /usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 1252.50.4)
    /usr/lib/libresolv.9.dylib (compatibility version 1.0.0, current version 1.0.0)
    /System/Library/Frameworks/Security.framework/Versions/A/Security (compatibility version 1.0.0, current version 58286.51.6)
    /usr/lib/libc++.1.dylib (compatibility version 1.0.0, current version 400.9.0)
    >
    
  • Always dies on uncaught errors.

  • Supports top-level await.

  • Aims to be browser compatible.

Status

Under development.

The prototype golang implementation is here. We are in the process of rewriting in C++/Rust to avoid future GC contention between Go and V8.

Progress towards first release is tracked here.

Roadmap is here. Also see this presentation.

Chat room.

Build instructions

To ensure reproducable builds, Deno has most of its dependencies in a git submodule. However, you need rustc installed separately.

You probably want ccache installed too.

To build:

# Fetch deps.
git clone --recurse-submodules https://github.com/denoland/deno.git
cd deno
./tools/setup.py

# Build.
./tools/build.py

# Run
./out/debug/deno tests/002_hello.ts

Other useful commands:

# Call ninja manually.
./third_party/depot_tools/ninja -C out/debug :all
# Build a release binary.
DENO_BUILD_MODE=release ./tools/build.py :deno
# List executable targets.
./third_party/depot_tools/gn ls out/debug //:* --as=output --type=executable
# List build configuation.
./third_party/depot_tools/gn args out/debug/ --list
# Edit build configuration.
./third_party/depot_tools/gn args out/debug/
# Describe a target.
./third_party/depot_tools/gn desc out/debug/ :deno
./third_party/depot_tools/gn help

Env vars: DENO_BUILD_MODE, DENO_BUILD_PATH, DENO_BUILD_ARGS.