// Copyright 2018 the V8 project authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. #if !V8_ENABLE_WEBASSEMBLY #error This header should only be included if WebAssembly is enabled. #endif // !V8_ENABLE_WEBASSEMBLY #ifndef V8_WASM_WASM_FEATURE_FLAGS_H_ #define V8_WASM_WASM_FEATURE_FLAGS_H_ // Each entry in this file generates a V8 command-line flag with the prefix // "--experimental-wasm-". // // For example, to enable "my_feature", pass // --experimental-wasm-my-feature to d8, or // --js-flags=--experimental-wasm-my-feature to Chrome. // // To disable "my_feature", add the "--no-" prefix: // --no-experimental-wasm-my-feature. // // See https://github.com/WebAssembly/proposals for an overview of current // WebAssembly proposals. // Experimental features (disabled by default). #define FOREACH_WASM_EXPERIMENTAL_FEATURE_FLAG(V) /* (force 80 columns) */ \ /* No official proposal (yet?). */ \ /* V8 side owner: clemensb */ \ V(compilation_hints, "compilation hints section", false) \ \ /* Instruction Tracing tool convention (early prototype, might change) */ \ /* Tool convention: https://github.com/WebAssembly/tool-conventions */ \ /* V8 side owner: jabraham */ \ V(instruction_tracing, "instruction tracing section", false) \ \ /* Non-specified, V8-only experimental additions to the GC proposal */ \ /* V8 side owner: jkummerow */ \ V(assume_ref_cast_succeeds, \ "assume ref.cast always succeeds and skip the related type check " \ "(unsafe)", \ false) \ V(ref_cast_nop, "enable unsafe ref.cast_nop instruction", false) \ V(skip_null_checks, \ "skip null checks for call.ref and array and struct operations (unsafe)", \ false) \ V(skip_bounds_checks, "skip array bounds checks (unsafe)", false) \ \ /* Branch Hinting proposal. */ \ /* https://github.com/WebAssembly/branch-hinting */ \ /* V8 side owner: jkummerow */ \ V(branch_hinting, "branch hinting", false) \ \ /* Stack Switching proposal. */ \ /* https://github.com/WebAssembly/stack-switching */ \ /* V8 side owner: thibaudm, fgm */ \ V(stack_switching, "stack switching", false) \ \ /* Shared-Everything Threads proposal. */ \ /* https://github.com/WebAssembly/shared-everything-threads */ \ /* V8 side owner: manoskouk */ \ V(shared, "shared-everything threads", false) \ \ /* FP16 proposal. */ \ /* https://github.com/WebAssembly/half-precision */ \ /* V8 side owner: irezvov */ \ V(fp16, "fp16", false) \ \ /* V8 side owner: irezvov */ \ V(growable_stacks, "growable stacks for jspi", false) // ############################################################################# // Staged features (disabled by default, but enabled via --wasm-staging (also // exposed as chrome://flags/#enable-experimental-webassembly-features). Staged // features get limited fuzzer coverage, and should come with their own tests. // They are not run through all fuzzers though and don't get much exposure in // the wild. Staged features are not necessarily fully stabilized. They should // be shipped with enough lead time to the next branch to allow for // stabilization. // Consider adding a chromium-side use counter if you want to track usage in the // wild (also see {V8::UseCounterFeature}). #define FOREACH_WASM_STAGING_FEATURE_FLAG(V) /* (force 80 columns) */ \ /* Type reflection proposal. */ \ /* https://github.com/webassembly/js-types */ \ /* V8 side owner: ahaas */ \ /* Staged in v7.8. */ \ V(type_reflection, "wasm type reflection in JS", false) \ \ /* Memory64 proposal. */ \ /* https://github.com/WebAssembly/memory64 */ \ /* V8 side owner: clemensb */ \ V(memory64, "memory64", false) \ \ /* Reference-Typed Strings Proposal. */ \ /* https://github.com/WebAssembly/stringref */ \ /* V8 side owner: jkummerow */ \ V(stringref, "reference-typed strings", false) \ \ /* Imported Strings Proposal. */ \ /* https://github.com/WebAssembly/js-string-builtins */ \ /* V8 side owner: jkummerow */ \ V(imported_strings, "imported strings", false) \ \ /* Exnref */ \ /* This flag enables the new exception handling proposal */ \ /* V8 side owner: thibaudm */ \ V(exnref, "exnref", false) \ \ /* JavaScript Promise Integration proposal. */ \ /* https://github.com/WebAssembly/js-promise-integration */ \ /* V8 side owner: thibaudm, fgm */ \ V(jspi, "javascript promise integration", false) // ############################################################################# // Shipped features (enabled by default). Remove the feature flag once they hit // stable and are expected to stay enabled. #define FOREACH_WASM_SHIPPED_FEATURE_FLAG(V) /* (force 80 columns) */ \ /* Legacy exception handling proposal. */ \ /* https://github.com/WebAssembly/exception-handling */ \ /* V8 side owner: thibaudm */ \ /* Staged in v8.9 */ \ /* Shipped in v9.5 */ \ V(legacy_eh, "legacy exception handling opcodes", true) \ \ /* Not user-visible, defined here so an Origin Trial can control it. */ \ /* V8 side owner: manoskouk, clemensb */ \ /* Staged in v11.3 */ \ /* Shipped in V12.7 */ \ /* Shipped for wasm-gc modules as part of wasm-gc in v11.9 */ \ /* Launch bug: https://crbug.com/40898108 */ \ V(inlining, "wasm-into-wasm inlining", true) // Combination of all available wasm feature flags. #define FOREACH_WASM_FEATURE_FLAG(V) \ FOREACH_WASM_EXPERIMENTAL_FEATURE_FLAG(V) \ FOREACH_WASM_STAGING_FEATURE_FLAG(V) \ FOREACH_WASM_SHIPPED_FEATURE_FLAG(V) // Consistency check: Experimental and staged features are off by default. #define CHECK_WASM_FEATURE_OFF_BY_DEFAULT(name, desc, enabled) \ static_assert(enabled == false); #define CHECK_WASM_FEATURE_ON_BY_DEFAULT(name, desc, enabled) \ static_assert(enabled == true); FOREACH_WASM_EXPERIMENTAL_FEATURE_FLAG(CHECK_WASM_FEATURE_OFF_BY_DEFAULT) FOREACH_WASM_STAGING_FEATURE_FLAG(CHECK_WASM_FEATURE_OFF_BY_DEFAULT) FOREACH_WASM_SHIPPED_FEATURE_FLAG(CHECK_WASM_FEATURE_ON_BY_DEFAULT) #undef CHECK_WASM_FEATURE_OFF_BY_DEFAULT #undef CHECK_WASM_FEATURE_ON_BY_DEFAULT #endif // V8_WASM_WASM_FEATURE_FLAGS_H_
Codebase Browser
chromium