WebAssembly Design Documents
Clone or download
Pull request Compare This branch is 173 commits behind WebAssembly:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
tools
.gitignore
AstSemantics.md
BinaryEncoding.md
CAndC++.md
CodeOfConduct.md
Contributing.md
DynamicLinking.md
Events.md
FAQ.md
FeatureTest.md
FutureFeatures.md
GC.md
HighLevelGoals.md
JITLibrary.md
JS.md
LICENSE
MVP.md
Modules.md
NonWeb.md
Nondeterminism.md
Portability.md
PostMVP.md
README.md
Rationale.md
Security.md
TextFormat.md
Tooling.md
UseCases.md
Web.md

README.md

WebAssembly Design

This repository contains documents describing the design and high-level overview of WebAssembly.

The documents and discussions in this repository are part of the WebAssembly Community Group.

Overview

WebAssembly or wasm is a new, portable, size- and load-time-efficient format suitable for compilation to the web.

WebAssembly is currently being designed as an open standard by a W3C Community Group that includes representatives from all major browsers. Expect the contents of this repository to be in flux: everything is still under discussion.

  • WebAssembly is efficient and fast: The wasm AST is designed to be encoded in a size- and load-time-efficient binary format. WebAssembly aims to execute at native speed by taking advantage of common hardware capabilities available on a wide range of platforms.

  • WebAssembly is safe: WebAssembly describes a memory-safe, sandboxed execution environment that may even be implemented inside existing JavaScript virtual machines. When embedded in the web, WebAssembly will enforce the same-origin and permissions security policies of the browser.

  • WebAssembly is open and debuggable: WebAssembly is designed to be pretty-printed in a textual format for debugging, testing, experimenting, optimizing, learning, teaching, and writing programs by hand. The textual format will be used when viewing the source of wasm modules on the web.

  • WebAssembly is part of the open web platform: WebAssembly is designed to maintain the versionless, feature-tested, and backwards-compatible nature of the web. WebAssembly modules will be able to call into and out of the JavaScript context and access browser functionality through the same Web APIs accessible from JavaScript. WebAssembly also supports non-web embeddings.

More Information

Resource Repository Location
High Level Goals design/HighLevelGoals.md
Frequently Asked Questions design/FAQ.md
Language Spec (in progress) spec/README.md

Design Process & Contributing

The actual WebAssembly specification is being developed in the spec repository. For now, high-level design discussions should continue to be held in the design repository, via issues and pull requests, so that the spec work can remain focused.

We've mapped out features we expect to ship:

  1. In the Minimum Viable Product (MVP);
  2. Closely after the MVP;
  3. In future versions.

Join us:

When contributing, please follow our Code of Ethics and Professional Conduct.