init

马宇豪

2024-07-16 f591c27b57e2418c9495bc02ae8cfff84d35bc18

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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
/*
    MIT License http://www.opensource.org/licenses/mit-license.php
    Author Tobias Koppers @sokra
*/
 
"use strict";
 
const makeSerializable = require("./util/makeSerializable");
 
/** @typedef {import("./AsyncDependenciesBlock")} AsyncDependenciesBlock */
/** @typedef {import("./ChunkGraph")} ChunkGraph */
/** @typedef {import("./ChunkGroup")} ChunkGroup */
/** @typedef {import("./Dependency")} Dependency */
/** @typedef {import("./Dependency").UpdateHashContext} UpdateHashContext */
/** @typedef {import("./serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
/** @typedef {import("./serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
/** @typedef {import("./util/Hash")} Hash */
 
/** @typedef {(d: Dependency) => boolean} DependencyFilterFunction */
 
/**
 * DependenciesBlock is the base class for all Module classes in webpack. It describes a
 * "block" of dependencies which are pointers to other DependenciesBlock instances. For example
 * when a Module has a CommonJs require statement, the DependencyBlock for the CommonJs module
 * would be added as a dependency to the Module. DependenciesBlock is inherited by two types of classes:
 * Module subclasses and AsyncDependenciesBlock subclasses. The only difference between the two is that
 * AsyncDependenciesBlock subclasses are used for code-splitting (async boundary) and Module subclasses are not.
 */
class DependenciesBlock {
    constructor() {
        /** @type {Dependency[]} */
        this.dependencies = [];
        /** @type {AsyncDependenciesBlock[]} */
        this.blocks = [];
        /** @type {DependenciesBlock} */
        this.parent = undefined;
    }
 
    getRootBlock() {
        /** @type {DependenciesBlock} */
        let current = this;
        while (current.parent) current = current.parent;
        return current;
    }
 
    /**
     * Adds a DependencyBlock to DependencyBlock relationship.
     * This is used for when a Module has a AsyncDependencyBlock tie (for code-splitting)
     *
     * @param {AsyncDependenciesBlock} block block being added
     * @returns {void}
     */
    addBlock(block) {
        this.blocks.push(block);
        block.parent = this;
    }
 
    /**
     * @param {Dependency} dependency dependency being tied to block.
     * This is an "edge" pointing to another "node" on module graph.
     * @returns {void}
     */
    addDependency(dependency) {
        this.dependencies.push(dependency);
    }
 
    /**
     * @param {Dependency} dependency dependency being removed
     * @returns {void}
     */
    removeDependency(dependency) {
        const idx = this.dependencies.indexOf(dependency);
        if (idx >= 0) {
            this.dependencies.splice(idx, 1);
        }
    }
 
    /**
     * Removes all dependencies and blocks
     * @returns {void}
     */
    clearDependenciesAndBlocks() {
        this.dependencies.length = 0;
        this.blocks.length = 0;
    }
 
    /**
     * @param {Hash} hash the hash used to track dependencies
     * @param {UpdateHashContext} context context
     * @returns {void}
     */
    updateHash(hash, context) {
        for (const dep of this.dependencies) {
            dep.updateHash(hash, context);
        }
        for (const block of this.blocks) {
            block.updateHash(hash, context);
        }
    }
 
    /**
     * @param {ObjectSerializerContext} context context
     */
    serialize({ write }) {
        write(this.dependencies);
        write(this.blocks);
    }
 
    /**
     * @param {ObjectDeserializerContext} context context
     */
    deserialize({ read }) {
        this.dependencies = read();
        this.blocks = read();
        for (const block of this.blocks) {
            block.parent = this;
        }
    }
}
 
makeSerializable(DependenciesBlock, "webpack/lib/DependenciesBlock");
 
module.exports = DependenciesBlock;