xwt
2025-07-04 b76e716ff4656191d73eba398e9eb39ee975e13b
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
/*
    MIT License http://www.opensource.org/licenses/mit-license.php
    Author Alexander Akait @alexander-akait
*/
 
"use strict";
 
const { WEBASSEMBLY_MODULE_TYPE_ASYNC } = require("../ModuleTypeConstants");
const RuntimeGlobals = require("../RuntimeGlobals");
const Template = require("../Template");
const AsyncWasmLoadingRuntimeModule = require("../wasm-async/AsyncWasmLoadingRuntimeModule");
 
/** @typedef {import("../Chunk")} Chunk */
/** @typedef {import("../Compiler")} Compiler */
 
const PLUGIN_NAME = "UniversalCompileAsyncWasmPlugin";
 
class UniversalCompileAsyncWasmPlugin {
    /**
     * Apply the plugin
     * @param {Compiler} compiler the compiler instance
     * @returns {void}
     */
    apply(compiler) {
        compiler.hooks.thisCompilation.tap(PLUGIN_NAME, compilation => {
            const globalWasmLoading = compilation.outputOptions.wasmLoading;
            /**
             * @param {Chunk} chunk chunk
             * @returns {boolean} true, if wasm loading is enabled for the chunk
             */
            const isEnabledForChunk = chunk => {
                const options = chunk.getEntryOptions();
                const wasmLoading =
                    options && options.wasmLoading !== undefined
                        ? options.wasmLoading
                        : globalWasmLoading;
                return wasmLoading === "universal";
            };
            const generateBeforeInstantiateStreaming = () =>
                Template.asString([
                    "if (!useFetch) {",
                    Template.indent(["return fallback();"]),
                    "}"
                ]);
            /**
             * @param {string} path path
             * @returns {string} code
             */
            const generateBeforeLoadBinaryCode = path =>
                Template.asString([
                    "var useFetch = typeof document !== 'undefined' || typeof self !== 'undefined';",
                    `var wasmUrl = ${path};`
                ]);
            /**
             * @type {(path: string) => string}
             */
            const generateLoadBinaryCode = () =>
                Template.asString([
                    "(useFetch",
                    Template.indent([
                        `? fetch(new URL(wasmUrl, ${compilation.outputOptions.importMetaName}.url))`
                    ]),
                    Template.indent([
                        ": Promise.all([import('fs'), import('url')]).then(([{ readFile }, { URL }]) => new Promise((resolve, reject) => {",
                        Template.indent([
                            `readFile(new URL(wasmUrl, ${compilation.outputOptions.importMetaName}.url), (err, buffer) => {`,
                            Template.indent([
                                "if (err) return reject(err);",
                                "",
                                "// Fake fetch response",
                                "resolve({",
                                Template.indent(["arrayBuffer() { return buffer; }"]),
                                "});"
                            ]),
                            "});"
                        ]),
                        "})))"
                    ])
                ]);
 
            compilation.hooks.runtimeRequirementInTree
                .for(RuntimeGlobals.instantiateWasm)
                .tap(PLUGIN_NAME, (chunk, set, { chunkGraph }) => {
                    if (!isEnabledForChunk(chunk)) return;
                    if (
                        !chunkGraph.hasModuleInGraph(
                            chunk,
                            m => m.type === WEBASSEMBLY_MODULE_TYPE_ASYNC
                        )
                    ) {
                        return;
                    }
                    compilation.addRuntimeModule(
                        chunk,
                        new AsyncWasmLoadingRuntimeModule({
                            generateBeforeLoadBinaryCode,
                            generateLoadBinaryCode,
                            generateBeforeInstantiateStreaming,
                            supportsStreaming: true
                        })
                    );
                });
        });
    }
}
 
module.exports = UniversalCompileAsyncWasmPlugin;