19
|
1 |
/******/ (function() { // webpackBootstrap |
|
2 |
/******/ "use strict"; |
|
3 |
/******/ // The require scope |
|
4 |
/******/ var __webpack_require__ = {}; |
|
5 |
/******/ |
|
6 |
/************************************************************************/ |
|
7 |
/******/ /* webpack/runtime/define property getters */ |
|
8 |
/******/ !function() { |
|
9 |
/******/ // define getter functions for harmony exports |
|
10 |
/******/ __webpack_require__.d = function(exports, definition) { |
|
11 |
/******/ for(var key in definition) { |
|
12 |
/******/ if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) { |
|
13 |
/******/ Object.defineProperty(exports, key, { enumerable: true, get: definition[key] }); |
|
14 |
/******/ } |
|
15 |
/******/ } |
9
|
16 |
/******/ }; |
19
|
17 |
/******/ }(); |
|
18 |
/******/ |
|
19 |
/******/ /* webpack/runtime/hasOwnProperty shorthand */ |
|
20 |
/******/ !function() { |
|
21 |
/******/ __webpack_require__.o = function(obj, prop) { return Object.prototype.hasOwnProperty.call(obj, prop); } |
|
22 |
/******/ }(); |
|
23 |
/******/ |
9
|
24 |
/************************************************************************/ |
19
|
25 |
var __webpack_exports__ = {}; |
9
|
26 |
|
19
|
27 |
// EXPORTS |
|
28 |
__webpack_require__.d(__webpack_exports__, { |
|
29 |
"default": function() { return /* binding */ deprecated; } |
|
30 |
}); |
|
31 |
|
|
32 |
// UNUSED EXPORTS: logged |
|
33 |
|
|
34 |
;// CONCATENATED MODULE: external ["wp","hooks"] |
|
35 |
var external_wp_hooks_namespaceObject = window["wp"]["hooks"]; |
|
36 |
;// CONCATENATED MODULE: ./node_modules/@wordpress/deprecated/build-module/index.js |
9
|
37 |
/** |
|
38 |
* WordPress dependencies |
|
39 |
*/ |
|
40 |
|
|
41 |
/** |
|
42 |
* Object map tracking messages which have been logged, for use in ensuring a |
|
43 |
* message is only logged once. |
|
44 |
* |
18
|
45 |
* @type {Record<string, true | undefined>} |
9
|
46 |
*/ |
|
47 |
|
18
|
48 |
const logged = Object.create(null); |
9
|
49 |
/** |
|
50 |
* Logs a message to notify developers about a deprecated feature. |
|
51 |
* |
18
|
52 |
* @param {string} feature Name of the deprecated feature. |
|
53 |
* @param {Object} [options] Personalisation options |
|
54 |
* @param {string} [options.since] Version in which the feature was deprecated. |
|
55 |
* @param {string} [options.version] Version in which the feature will be removed. |
|
56 |
* @param {string} [options.alternative] Feature to use instead |
|
57 |
* @param {string} [options.plugin] Plugin name if it's a plugin feature |
|
58 |
* @param {string} [options.link] Link to documentation |
|
59 |
* @param {string} [options.hint] Additional message to help transition away from the deprecated feature. |
9
|
60 |
* |
|
61 |
* @example |
|
62 |
* ```js |
|
63 |
* import deprecated from '@wordpress/deprecated'; |
|
64 |
* |
|
65 |
* deprecated( 'Eating meat', { |
18
|
66 |
* since: '2019.01.01' |
|
67 |
* version: '2020.01.01', |
9
|
68 |
* alternative: 'vegetables', |
|
69 |
* plugin: 'the earth', |
|
70 |
* hint: 'You may find it beneficial to transition gradually.', |
|
71 |
* } ); |
|
72 |
* |
18
|
73 |
* // Logs: 'Eating meat is deprecated since version 2019.01.01 and will be removed from the earth in version 2020.01.01. Please use vegetables instead. Note: You may find it beneficial to transition gradually.' |
9
|
74 |
* ``` |
|
75 |
*/ |
|
76 |
|
19
|
77 |
function deprecated(feature) { |
|
78 |
let options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {}; |
18
|
79 |
const { |
|
80 |
since, |
|
81 |
version, |
|
82 |
alternative, |
|
83 |
plugin, |
|
84 |
link, |
|
85 |
hint |
|
86 |
} = options; |
|
87 |
const pluginMessage = plugin ? ` from ${plugin}` : ''; |
|
88 |
const sinceMessage = since ? ` since version ${since}` : ''; |
|
89 |
const versionMessage = version ? ` and will be removed${pluginMessage} in version ${version}` : ''; |
|
90 |
const useInsteadMessage = alternative ? ` Please use ${alternative} instead.` : ''; |
|
91 |
const linkMessage = link ? ` See: ${link}` : ''; |
|
92 |
const hintMessage = hint ? ` Note: ${hint}` : ''; |
|
93 |
const message = `${feature} is deprecated${sinceMessage}${versionMessage}.${useInsteadMessage}${linkMessage}${hintMessage}`; // Skip if already logged. |
9
|
94 |
|
|
95 |
if (message in logged) { |
|
96 |
return; |
|
97 |
} |
|
98 |
/** |
|
99 |
* Fires whenever a deprecated feature is encountered |
|
100 |
* |
|
101 |
* @param {string} feature Name of the deprecated feature. |
|
102 |
* @param {?Object} options Personalisation options |
18
|
103 |
* @param {string} options.since Version in which the feature was deprecated. |
9
|
104 |
* @param {?string} options.version Version in which the feature will be removed. |
|
105 |
* @param {?string} options.alternative Feature to use instead |
|
106 |
* @param {?string} options.plugin Plugin name if it's a plugin feature |
|
107 |
* @param {?string} options.link Link to documentation |
|
108 |
* @param {?string} options.hint Additional message to help transition away from the deprecated feature. |
|
109 |
* @param {?string} message Message sent to console.warn |
|
110 |
*/ |
|
111 |
|
|
112 |
|
19
|
113 |
(0,external_wp_hooks_namespaceObject.doAction)('deprecated', feature, options, message); // eslint-disable-next-line no-console |
9
|
114 |
|
|
115 |
console.warn(message); |
|
116 |
logged[message] = true; |
|
117 |
} |
18
|
118 |
/** @typedef {import('utility-types').NonUndefined<Parameters<typeof deprecated>[1]>} DeprecatedOptions */ |
9
|
119 |
|
19
|
120 |
(window.wp = window.wp || {}).deprecated = __webpack_exports__["default"]; |
|
121 |
/******/ })() |
|
122 |
; |