deno/README.md

deno

Linux & Mac	Windows

A new way to JavaScript.

• Supports TypeScript out of the box. Uses a recent version of V8. 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 target/release/deno
  -rwxr-xr-x  1 rld  staff    48M Aug  2 13:24 target/release/deno
  > otool -L target/release/deno
  target/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.

• Aims to support top-level await.

• Aims to be browser compatible.

See the website for more info deno.land.

Install

With Shell:

curl -L https://deno.land/x/install/install.sh | bash

With PowerShell:

iex (iwr https://deno.land/x/install/install.ps1)

Note: Depending on your security settings, you may have to run Set-ExecutionPolicy RemoteSigned -Scope CurrentUser first to allow downloaded scripts to be executed.

With Scoop:

scoop install deno

Try it:

> deno https://deno.land/thumb.ts

See deno_install for more installation methods..

Build locally (advanced users only)

For instructions to build this project locally, please see the docs.