Add wasm64 backend support for the web

nickbabcock · kpreid · commit 4e5883307284 · 2026-07-15T09:15:33.000-07:00
This commit:

- Bumps glow to 0.18 which gains support for wasm64
- Updates cfg gates from `target_arch = "wasm32"` to `target_family =
"wasm"`

This commit, unfortunately, does not touch upon example code as that
brings in getrandom 0.3 (0.4 supports wasm64) through flume and
futures-lite
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -188,6 +188,13 @@ jobs:
             tier: 2
             kind: web
 
+          - name: WebAssembly 64-bit
+            os: ubuntu-24.04
+            target: wasm64-unknown-unknown
+            kind: wgpu-only
+            tier: 3
+            extra-flags: -Zbuild-std=std,panic_abort
+
           - name: Emscripten
             os: ubuntu-24.04
             target: wasm32-unknown-emscripten
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -44,6 +44,10 @@ Bottom level categories:
 
 ### Added/New Features
 
+#### General
+
+- Support the `wasm64-unknown-unknown` target for the web backend. Building for wasm64 requires a nightly toolchain with `-Z build-std=std,panic_abort`. By @nickbabcock in [#9836](https://github.com/gfx-rs/wgpu/pull/9836).
+
 #### Hal
 
 - Add `BufferBinding::buffer`, a public read accessor for the bound buffer, which was previously inaccessible to out-of-tree `wgpu_hal::Api` implementations. By @danlehmann in [#9820](https://github.com/gfx-rs/wgpu/pull/9820).
@@ -82,6 +86,16 @@ Bottom level categories:
 
 - Fixed signed integer `%` (and `%=`) returning the wrong result for negative operands in the GLSL (OpenGL/GLES) backend, e.g. `-1 % 768` yielding `255` instead of `-1`. GLSL's `%` is undefined when either operand is negative, so signed remainder is now lowered as `a - b * (a / b)`, matching the SPIR-V, HLSL, and Metal backends. By @mstampfli in [#9687](https://github.com/gfx-rs/wgpu/pull/9687).
 
+### Dependency Updates
+
+#### General
+
+- Raise the minimum version of the `wasm-bindgen` family to the earliest releases that support wasm64. By @nickbabcock in [#9836](https://github.com/gfx-rs/wgpu/pull/9836).
+
+#### GLES
+
+- Update `glow` to 0.18 for wasm64 support. By @nickbabcock in [#9836](https://github.com/gfx-rs/wgpu/pull/9836).
+
 ## v30.0.0 (2026-07-01)
 
 ### Major changes
diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -294,21 +294,21 @@ gpu-allocator = { version = "0.28", default-features = false, features = [
 
 # Gles dependencies
 khronos-egl = "6"
-glow = "0.17"
+glow = "0.18"
 glutin = { version = "0.32", default-features = false }
 glutin-winit = { version = "0.5", default-features = false }
 glutin_wgl_sys = "0.6"
 
 # DX12 and GLES dependencies
 windows = { version = "0.62", default-features = false }
 
-# wasm32 dependencies
+# wasm dependencies
 console_error_panic_hook = "0.1.5"
 console_log = "1"
-js-sys = { version = "0.3.85", default-features = false }
-wasm-bindgen = { version = "0.2.108", default-features = false }
-wasm-bindgen-futures = { version = "0.4.58", default-features = false }
-web-sys = { version = "0.3.85", default-features = false }
+js-sys = { version = "0.3.100", default-features = false }
+wasm-bindgen = { version = "0.2.123", default-features = false }
+wasm-bindgen-futures = { version = "0.4.73", default-features = false }
+web-sys = { version = "0.3.100", default-features = false }
 web-time = "1.1.0"
 
 # deno dependencies
diff --git a/examples/standalone/03_hdr_surface/Cargo.toml b/examples/standalone/03_hdr_surface/Cargo.toml
@@ -24,9 +24,9 @@ block2 = "0.6.2"
 
 [target.'cfg(target_arch = "wasm32")'.dependencies]
 console_error_panic_hook = "0.1.5"
-wasm-bindgen = "0.2.108"
-wasm-bindgen-futures = "0.4.58"
-web-sys = { version = "0.3.85", features = [
+wasm-bindgen = "0.2.123"
+wasm-bindgen-futures = "0.4.73"
+web-sys = { version = "0.3.100", features = [
     "console",
     "Document",
     "Element",
diff --git a/wgpu-core/Cargo.toml b/wgpu-core/Cargo.toml
@@ -172,7 +172,7 @@ wgpu-core-deps-apple = { workspace = true, optional = true }
 [target.'cfg(target_os = "emscripten")'.dependencies]
 wgpu-core-deps-emscripten = { workspace = true, optional = true }
 
-[target.'cfg(all(target_arch = "wasm32", not(target_os = "emscripten")))'.dependencies]
+[target.'cfg(all(target_family = "wasm", not(target_os = "emscripten")))'.dependencies]
 wgpu-core-deps-wasm = { workspace = true, optional = true }
 
 [target.'cfg(any(target_os = "linux", target_os = "android", target_os = "freebsd"))'.dependencies]
diff --git a/wgpu-core/build.rs b/wgpu-core/build.rs
@@ -4,12 +4,12 @@ fn main() {
         send_sync: { all(
             feature = "std",
             any(
-                not(target_arch = "wasm32"),
+                not(target_family = "wasm"),
                 all(feature = "fragile-send-sync-non-atomic-wasm", not(target_feature = "atomics"))
             )
         ) },
         dx12: { all(target_os = "windows", feature = "dx12") },
-        webgl: { all(target_arch = "wasm32", not(target_os = "emscripten"), feature = "webgl") },
+        webgl: { all(target_family = "wasm", not(target_os = "emscripten"), feature = "webgl") },
         gles: { any(
             all(windows_linux_android, feature = "gles"), // Regular GLES
             all(webgl), // WebGL
diff --git a/wgpu-core/platform-deps/wasm/Cargo.toml b/wgpu-core/platform-deps/wasm/Cargo.toml
@@ -19,7 +19,7 @@ rust-version = "1.76"
 webgl = ["wgpu-hal/gles"]
 
 # Depend on wgpu-hal conditionally, so that the above features only apply to wgpu-hal on this set of platforms.
-[target.'cfg(all(target_arch = "wasm32", not(target_os = "emscripten")))'.dependencies]
+[target.'cfg(all(target_family = "wasm", not(target_os = "emscripten")))'.dependencies]
 wgpu-hal.workspace = true
 
 [lints]
diff --git a/wgpu-core/src/device/resource.rs b/wgpu-core/src/device/resource.rs
@@ -5938,7 +5938,7 @@ impl Device {
                     Ok(wgt::PollStatus::Poll) => {
                         unreachable!("Cannot get a Poll result from a Wait action.")
                     }
-                    Err(WaitIdleError::Timeout) if cfg!(target_arch = "wasm32") => {
+                    Err(WaitIdleError::Timeout) if cfg!(target_family = "wasm") => {
                         // On wasm, you cannot actually successfully wait for the surface.
                         // However WebGL does not actually require you do this, so ignoring
                         // the failure is totally fine. See
diff --git a/wgpu-core/src/lib.rs b/wgpu-core/src/lib.rs
@@ -12,7 +12,7 @@
 // When we have no backends, we end up with a lot of dead or otherwise unreachable code.
 #![cfg_attr(
     all(
-        not(all(feature = "vulkan", not(target_arch = "wasm32"))),
+        not(all(feature = "vulkan", not(target_family = "wasm"))),
         not(all(feature = "metal", any(target_vendor = "apple"))),
         not(all(feature = "dx12", windows)),
         not(feature = "gles"),
diff --git a/wgpu-hal/Cargo.toml b/wgpu-hal/Cargo.toml
@@ -234,7 +234,7 @@ glow = { workspace = true, optional = true }
 ### Platform: Native ###
 ########################
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+[target.'cfg(not(target_family = "wasm"))'.dependencies]
 # Backend: Vulkan and Dx12
 gpu-allocator = { workspace = true, optional = true }
 # Backend: Vulkan
@@ -317,7 +317,7 @@ ndk-sys = { workspace = true, optional = true }
 ### Platform: Webassembly ###
 #############################
 
-[target.'cfg(all(target_arch = "wasm32", not(target_os = "emscripten")))'.dependencies]
+[target.'cfg(all(target_family = "wasm", not(target_os = "emscripten")))'.dependencies]
 # Backend: GLES
 wasm-bindgen = { workspace = true, optional = true }
 web-sys = { workspace = true, optional = true, features = [
@@ -361,6 +361,6 @@ naga = { workspace = true, features = ["wgsl-in", "termcolor"] }
 winit.workspace = true # for "halmark" example
 
 ### Platform: Windows + MacOS + Linux for "raw-gles" example ###
-[target.'cfg(not(any(target_arch = "wasm32", target_os = "ios", target_os = "visionos", target_env = "ohos")))'.dev-dependencies]
+[target.'cfg(not(any(target_family = "wasm", target_os = "ios", target_os = "visionos", target_env = "ohos")))'.dev-dependencies]
 glutin-winit = { workspace = true, features = ["egl", "wgl", "wayland", "x11"] }
 glutin = { workspace = true, features = ["egl", "wgl", "wayland", "x11"] }
diff --git a/wgpu-hal/build.rs b/wgpu-hal/build.rs
@@ -1,11 +1,11 @@
 fn main() {
     cfg_aliases::cfg_aliases! {
-        native: { not(target_arch = "wasm32") },
+        native: { not(target_family = "wasm") },
         send_sync: { any(
-            not(target_arch = "wasm32"),
+            not(target_family = "wasm"),
             all(feature = "fragile-send-sync-non-atomic-wasm", not(target_feature = "atomics"))
         ) },
-        webgl: { all(target_arch = "wasm32", not(target_os = "emscripten"), gles) },
+        webgl: { all(target_family = "wasm", not(target_os = "emscripten"), gles) },
         Emscripten: { all(target_os = "emscripten", gles) },
         dx12: { all(target_os = "windows", feature = "dx12") },
         gles: { all(feature = "gles") },
@@ -14,15 +14,15 @@ fn main() {
         gles_with_std: { all(
             feature = "gles",
             any(
-                not(target_arch = "wasm32"),
+                not(target_family = "wasm"),
                 // Accept wasm32-unknown-unknown, which uniquely has a stub `std`
                 all(target_vendor = "unknown", target_os = "unknown"),
                 // Accept wasm32-unknown-emscripten and similar, which has a real `std`
                 target_os = "emscripten"
             )
         ) },
         metal: { all(target_vendor = "apple", feature = "metal") },
-        vulkan: { all(not(target_arch = "wasm32"), feature = "vulkan") },
+        vulkan: { all(not(target_family = "wasm"), feature = "vulkan") },
         drm: { all(
             feature = "drm",
             any(target_os = "linux", target_os = "freebsd", target_os = "netbsd", target_os = "openbsd")
diff --git a/wgpu-hal/src/gles/adapter.rs b/wgpu-hal/src/gles/adapter.rs
@@ -941,7 +941,7 @@ impl super::Adapter {
         // Drop the GL guard so we can move the context into AdapterShared
         // ( on Wasm the gl handle is just a ref so we tell clippy to allow
         // dropping the ref )
-        #[cfg_attr(target_arch = "wasm32", allow(dropping_references))]
+        #[cfg_attr(target_family = "wasm", allow(dropping_references))]
         drop(gl);
 
         Some(crate::ExposedAdapter {
diff --git a/wgpu-hal/src/gles/device.rs b/wgpu-hal/src/gles/device.rs
@@ -246,7 +246,7 @@ impl super::Device {
         gl: &glow::Context,
         shader: &str,
         naga_stage: naga::ShaderStage,
-        #[cfg_attr(target_arch = "wasm32", allow(unused))] label: Option<&str>,
+        #[cfg_attr(target_family = "wasm", allow(unused))] label: Option<&str>,
     ) -> Result<glow::Shader, crate::PipelineError> {
         let target = match naga_stage {
             naga::ShaderStage::Vertex => glow::VERTEX_SHADER,
@@ -400,7 +400,7 @@ impl super::Device {
         gl: &glow::Context,
         shaders: ArrayVec<ShaderStage<'a>, { crate::MAX_CONCURRENT_SHADER_STAGES }>,
         layout: &super::PipelineLayout,
-        #[cfg_attr(target_arch = "wasm32", allow(unused))] label: Option<&str>,
+        #[cfg_attr(target_family = "wasm", allow(unused))] label: Option<&str>,
         multiview_mask: Option<NonZeroU32>,
     ) -> Result<Arc<super::PipelineInner>, crate::PipelineError> {
         let mut program_stages = ArrayVec::new();
@@ -462,7 +462,7 @@ impl super::Device {
         gl: &glow::Context,
         shaders: ArrayVec<ShaderStage<'a>, { crate::MAX_CONCURRENT_SHADER_STAGES }>,
         layout: &super::PipelineLayout,
-        #[cfg_attr(target_arch = "wasm32", allow(unused))] label: Option<&str>,
+        #[cfg_attr(target_family = "wasm", allow(unused))] label: Option<&str>,
         multiview_mask: Option<NonZeroU32>,
         glsl_version: naga::back::glsl::Version,
         private_caps: PrivateCapabilities,
@@ -1680,7 +1680,7 @@ impl crate::Device for super::Device {
     }
     unsafe fn destroy_pipeline_cache(&self, _: super::PipelineCache) {}
 
-    #[cfg_attr(target_arch = "wasm32", allow(unused))]
+    #[cfg_attr(target_family = "wasm", allow(unused))]
     unsafe fn create_query_set(
         &self,
         desc: &wgt::QuerySetDescriptor<crate::Label>,
@@ -1736,7 +1736,7 @@ impl crate::Device for super::Device {
         &self,
         fence: &super::Fence,
     ) -> Result<crate::FenceValue, crate::DeviceError> {
-        #[cfg_attr(target_arch = "wasm32", allow(clippy::needless_borrow))]
+        #[cfg_attr(target_family = "wasm", allow(clippy::needless_borrow))]
         Ok(fence.get_latest(&self.shared.context.lock()))
     }
     unsafe fn wait(
diff --git a/wgpu-hal/src/gles/queue.rs b/wgpu-hal/src/gles/queue.rs
@@ -193,7 +193,7 @@ impl super::Queue {
         &self,
         gl: &glow::Context,
         command: &C,
-        #[cfg_attr(target_arch = "wasm32", allow(unused))] data_bytes: &[u8],
+        #[cfg_attr(target_family = "wasm", allow(unused))] data_bytes: &[u8],
         queries: &[glow::Query],
     ) {
         match *command {
diff --git a/wgpu-types/Cargo.toml b/wgpu-types/Cargo.toml
@@ -68,7 +68,7 @@ serde = { workspace = true, default-features = false, features = [
 ], optional = true }
 static_assertions.workspace = true
 
-[target.'cfg(target_arch = "wasm32")'.dependencies]
+[target.'cfg(target_family = "wasm")'.dependencies]
 js-sys = { workspace = true, optional = true, default-features = false }
 web-sys = { workspace = true, optional = true, default-features = false, features = [
     "ImageBitmap",
diff --git a/wgpu-types/src/send_sync.rs b/wgpu-types/src/send_sync.rs
@@ -1,31 +1,31 @@
 pub trait WasmNotSendSync: WasmNotSend + WasmNotSync {}
 impl<T: WasmNotSend + WasmNotSync> WasmNotSendSync for T {}
 #[cfg(any(
-    not(target_arch = "wasm32"),
+    not(target_family = "wasm"),
     all(
         feature = "fragile-send-sync-non-atomic-wasm",
         not(target_feature = "atomics")
     )
 ))]
 pub trait WasmNotSend: Send {}
 #[cfg(any(
-    not(target_arch = "wasm32"),
+    not(target_family = "wasm"),
     all(
         feature = "fragile-send-sync-non-atomic-wasm",
         not(target_feature = "atomics")
     )
 ))]
 impl<T: Send> WasmNotSend for T {}
 #[cfg(not(any(
-    not(target_arch = "wasm32"),
+    not(target_family = "wasm"),
     all(
         feature = "fragile-send-sync-non-atomic-wasm",
         not(target_feature = "atomics")
     )
 )))]
 pub trait WasmNotSend {}
 #[cfg(not(any(
-    not(target_arch = "wasm32"),
+    not(target_family = "wasm"),
     all(
         feature = "fragile-send-sync-non-atomic-wasm",
         not(target_feature = "atomics")
@@ -34,31 +34,31 @@ pub trait WasmNotSend {}
 impl<T> WasmNotSend for T {}
 
 #[cfg(any(
-    not(target_arch = "wasm32"),
+    not(target_family = "wasm"),
     all(
         feature = "fragile-send-sync-non-atomic-wasm",
         not(target_feature = "atomics")
     )
 ))]
 pub trait WasmNotSync: Sync {}
 #[cfg(any(
-    not(target_arch = "wasm32"),
+    not(target_family = "wasm"),
     all(
         feature = "fragile-send-sync-non-atomic-wasm",
         not(target_feature = "atomics")
     )
 ))]
 impl<T: Sync> WasmNotSync for T {}
 #[cfg(not(any(
-    not(target_arch = "wasm32"),
+    not(target_family = "wasm"),
     all(
         feature = "fragile-send-sync-non-atomic-wasm",
         not(target_feature = "atomics")
     )
 )))]
 pub trait WasmNotSync {}
 #[cfg(not(any(
-    not(target_arch = "wasm32"),
+    not(target_family = "wasm"),
     all(
         feature = "fragile-send-sync-non-atomic-wasm",
         not(target_feature = "atomics")
diff --git a/wgpu-types/src/texture/external_image.rs b/wgpu-types/src/texture/external_image.rs
diff --git a/wgpu/Cargo.toml b/wgpu/Cargo.toml
diff --git a/wgpu/build.rs b/wgpu/build.rs

Original file line number	Diff line number	Diff line change
`@@ -5938,7 +5938,7 @@ impl Device {`
`5938`	`5938`	`Ok(wgt::PollStatus::Poll) => {`
`5939`	`5939`	`unreachable!("Cannot get a Poll result from a Wait action.")`
`5940`	`5940`	`}`
`5941`		`- Err(WaitIdleError::Timeout) if cfg!(target_arch = "wasm32") => {`
	`5941`	`+ Err(WaitIdleError::Timeout) if cfg!(target_family = "wasm") => {`
`5942`	`5942`	`// On wasm, you cannot actually successfully wait for the surface.`
`5943`	`5943`	`// However WebGL does not actually require you do this, so ignoring`
`5944`	`5944`	`// the failure is totally fine. See`