forked from docsifyjs/docsify
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathlifecycle.js
More file actions
113 lines (99 loc) · 2.8 KB
/
Copy pathlifecycle.js
File metadata and controls
113 lines (99 loc) · 2.8 KB
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
import { noop } from '../util/core.js';
/** @typedef {import('../Docsify.js').Constructor} Constructor */
/**
* @template {!Constructor} T
* @param {T} Base - The class to extend
*/
export function Lifecycle(Base) {
return class Lifecycle extends Base {
/** @type {Record<string, Function[]>} */
_hooks = {};
_lifecycle = /** @type {Hooks} */ ({});
initLifecycle() {
const hooks = [
'init',
'mounted',
'beforeEach',
'afterEach',
'doneEach',
'ready',
];
hooks.forEach((/** @type {string} */ hook) => {
/** @type {Function[]} */
const arr = (this._hooks[hook] = []);
this._lifecycle[hook] = (/** @type {Function} */ fn) => arr.push(fn);
});
}
/**
* @param {string} hookName
* @param {any} [data]
* @param {Function} [next]
*/
callHook(hookName, data, next = noop) {
const queue = this._hooks[hookName];
const catchPluginErrors = this.config.catchPluginErrors;
/**
* @param {number} index
*/
const step = function (index) {
const hookFn = queue[index];
if (index >= queue.length) {
next(data);
} else if (typeof hookFn === 'function') {
const errTitle = 'Docsify plugin error';
if (hookFn.length === 2) {
// FIXME this does not catch async errors. We can support async
// functions for this, or add a second arg to next() functions.
try {
hookFn(data, (/** @type {string} */ result) => {
data = result === undefined ? data : result;
step(index + 1);
});
} catch (err) {
if (catchPluginErrors) {
// eslint-disable-next-line no-console
console.error(errTitle, err);
} else {
throw err;
}
step(index + 1);
}
} else {
try {
const result = hookFn(data);
data = result === undefined ? data : result;
step(index + 1);
} catch (err) {
if (catchPluginErrors) {
// eslint-disable-next-line no-console
console.error(errTitle, err);
} else {
throw err;
}
step(index + 1);
}
}
} else {
step(index + 1);
}
};
step(0);
}
};
}
/**
@typedef {{
init(): void
mounted(): void
beforeEach: (
((markdown: string) => string) |
((markdown: string, next: (markdown?: string) => void) => void)
)
afterEach: (
((html: string) => string) |
((html: string, next: (html?: string) => void) => void)
)
doneEach(): void
ready(): void
}} Hooks
*/