|
9
|
1 |
this["wp"] = this["wp"] || {}; this["wp"]["deprecated"] = |
|
|
2 |
/******/ (function(modules) { // webpackBootstrap |
|
|
3 |
/******/ // The module cache |
|
|
4 |
/******/ var installedModules = {}; |
|
|
5 |
/******/ |
|
|
6 |
/******/ // The require function |
|
|
7 |
/******/ function __webpack_require__(moduleId) { |
|
|
8 |
/******/ |
|
|
9 |
/******/ // Check if module is in cache |
|
|
10 |
/******/ if(installedModules[moduleId]) { |
|
|
11 |
/******/ return installedModules[moduleId].exports; |
|
|
12 |
/******/ } |
|
|
13 |
/******/ // Create a new module (and put it into the cache) |
|
|
14 |
/******/ var module = installedModules[moduleId] = { |
|
|
15 |
/******/ i: moduleId, |
|
|
16 |
/******/ l: false, |
|
|
17 |
/******/ exports: {} |
|
|
18 |
/******/ }; |
|
|
19 |
/******/ |
|
|
20 |
/******/ // Execute the module function |
|
|
21 |
/******/ modules[moduleId].call(module.exports, module, module.exports, __webpack_require__); |
|
|
22 |
/******/ |
|
|
23 |
/******/ // Flag the module as loaded |
|
|
24 |
/******/ module.l = true; |
|
|
25 |
/******/ |
|
|
26 |
/******/ // Return the exports of the module |
|
|
27 |
/******/ return module.exports; |
|
|
28 |
/******/ } |
|
|
29 |
/******/ |
|
|
30 |
/******/ |
|
|
31 |
/******/ // expose the modules object (__webpack_modules__) |
|
|
32 |
/******/ __webpack_require__.m = modules; |
|
|
33 |
/******/ |
|
|
34 |
/******/ // expose the module cache |
|
|
35 |
/******/ __webpack_require__.c = installedModules; |
|
|
36 |
/******/ |
|
|
37 |
/******/ // define getter function for harmony exports |
|
|
38 |
/******/ __webpack_require__.d = function(exports, name, getter) { |
|
|
39 |
/******/ if(!__webpack_require__.o(exports, name)) { |
|
|
40 |
/******/ Object.defineProperty(exports, name, { enumerable: true, get: getter }); |
|
|
41 |
/******/ } |
|
|
42 |
/******/ }; |
|
|
43 |
/******/ |
|
|
44 |
/******/ // define __esModule on exports |
|
|
45 |
/******/ __webpack_require__.r = function(exports) { |
|
|
46 |
/******/ if(typeof Symbol !== 'undefined' && Symbol.toStringTag) { |
|
|
47 |
/******/ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' }); |
|
|
48 |
/******/ } |
|
|
49 |
/******/ Object.defineProperty(exports, '__esModule', { value: true }); |
|
|
50 |
/******/ }; |
|
|
51 |
/******/ |
|
|
52 |
/******/ // create a fake namespace object |
|
|
53 |
/******/ // mode & 1: value is a module id, require it |
|
|
54 |
/******/ // mode & 2: merge all properties of value into the ns |
|
|
55 |
/******/ // mode & 4: return value when already ns object |
|
|
56 |
/******/ // mode & 8|1: behave like require |
|
|
57 |
/******/ __webpack_require__.t = function(value, mode) { |
|
|
58 |
/******/ if(mode & 1) value = __webpack_require__(value); |
|
|
59 |
/******/ if(mode & 8) return value; |
|
|
60 |
/******/ if((mode & 4) && typeof value === 'object' && value && value.__esModule) return value; |
|
|
61 |
/******/ var ns = Object.create(null); |
|
|
62 |
/******/ __webpack_require__.r(ns); |
|
|
63 |
/******/ Object.defineProperty(ns, 'default', { enumerable: true, value: value }); |
|
|
64 |
/******/ if(mode & 2 && typeof value != 'string') for(var key in value) __webpack_require__.d(ns, key, function(key) { return value[key]; }.bind(null, key)); |
|
|
65 |
/******/ return ns; |
|
|
66 |
/******/ }; |
|
|
67 |
/******/ |
|
|
68 |
/******/ // getDefaultExport function for compatibility with non-harmony modules |
|
|
69 |
/******/ __webpack_require__.n = function(module) { |
|
|
70 |
/******/ var getter = module && module.__esModule ? |
|
|
71 |
/******/ function getDefault() { return module['default']; } : |
|
|
72 |
/******/ function getModuleExports() { return module; }; |
|
|
73 |
/******/ __webpack_require__.d(getter, 'a', getter); |
|
|
74 |
/******/ return getter; |
|
|
75 |
/******/ }; |
|
|
76 |
/******/ |
|
|
77 |
/******/ // Object.prototype.hasOwnProperty.call |
|
|
78 |
/******/ __webpack_require__.o = function(object, property) { return Object.prototype.hasOwnProperty.call(object, property); }; |
|
|
79 |
/******/ |
|
|
80 |
/******/ // __webpack_public_path__ |
|
|
81 |
/******/ __webpack_require__.p = ""; |
|
|
82 |
/******/ |
|
|
83 |
/******/ |
|
|
84 |
/******/ // Load entry module and return exports |
|
18
|
85 |
/******/ return __webpack_require__(__webpack_require__.s = "+BeG"); |
|
9
|
86 |
/******/ }) |
|
|
87 |
/************************************************************************/ |
|
|
88 |
/******/ ({ |
|
|
89 |
|
|
18
|
90 |
/***/ "+BeG": |
|
9
|
91 |
/***/ (function(module, __webpack_exports__, __webpack_require__) { |
|
|
92 |
|
|
|
93 |
"use strict"; |
|
|
94 |
__webpack_require__.r(__webpack_exports__); |
|
|
95 |
/* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "logged", function() { return logged; }); |
|
|
96 |
/* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "default", function() { return deprecated; }); |
|
18
|
97 |
/* harmony import */ var _wordpress_hooks__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__("g56x"); |
|
9
|
98 |
/* harmony import */ var _wordpress_hooks__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(_wordpress_hooks__WEBPACK_IMPORTED_MODULE_0__); |
|
|
99 |
/** |
|
|
100 |
* WordPress dependencies |
|
|
101 |
*/ |
|
|
102 |
|
|
|
103 |
/** |
|
|
104 |
* Object map tracking messages which have been logged, for use in ensuring a |
|
|
105 |
* message is only logged once. |
|
|
106 |
* |
|
18
|
107 |
* @type {Record<string, true | undefined>} |
|
9
|
108 |
*/ |
|
|
109 |
|
|
18
|
110 |
const logged = Object.create(null); |
|
9
|
111 |
/** |
|
|
112 |
* Logs a message to notify developers about a deprecated feature. |
|
|
113 |
* |
|
18
|
114 |
* @param {string} feature Name of the deprecated feature. |
|
|
115 |
* @param {Object} [options] Personalisation options |
|
|
116 |
* @param {string} [options.since] Version in which the feature was deprecated. |
|
|
117 |
* @param {string} [options.version] Version in which the feature will be removed. |
|
|
118 |
* @param {string} [options.alternative] Feature to use instead |
|
|
119 |
* @param {string} [options.plugin] Plugin name if it's a plugin feature |
|
|
120 |
* @param {string} [options.link] Link to documentation |
|
|
121 |
* @param {string} [options.hint] Additional message to help transition away from the deprecated feature. |
|
9
|
122 |
* |
|
|
123 |
* @example |
|
|
124 |
* ```js |
|
|
125 |
* import deprecated from '@wordpress/deprecated'; |
|
|
126 |
* |
|
|
127 |
* deprecated( 'Eating meat', { |
|
18
|
128 |
* since: '2019.01.01' |
|
|
129 |
* version: '2020.01.01', |
|
9
|
130 |
* alternative: 'vegetables', |
|
|
131 |
* plugin: 'the earth', |
|
|
132 |
* hint: 'You may find it beneficial to transition gradually.', |
|
|
133 |
* } ); |
|
|
134 |
* |
|
18
|
135 |
* // 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
|
136 |
* ``` |
|
|
137 |
*/ |
|
|
138 |
|
|
18
|
139 |
function deprecated(feature, options = {}) { |
|
|
140 |
const { |
|
|
141 |
since, |
|
|
142 |
version, |
|
|
143 |
alternative, |
|
|
144 |
plugin, |
|
|
145 |
link, |
|
|
146 |
hint |
|
|
147 |
} = options; |
|
|
148 |
const pluginMessage = plugin ? ` from ${plugin}` : ''; |
|
|
149 |
const sinceMessage = since ? ` since version ${since}` : ''; |
|
|
150 |
const versionMessage = version ? ` and will be removed${pluginMessage} in version ${version}` : ''; |
|
|
151 |
const useInsteadMessage = alternative ? ` Please use ${alternative} instead.` : ''; |
|
|
152 |
const linkMessage = link ? ` See: ${link}` : ''; |
|
|
153 |
const hintMessage = hint ? ` Note: ${hint}` : ''; |
|
|
154 |
const message = `${feature} is deprecated${sinceMessage}${versionMessage}.${useInsteadMessage}${linkMessage}${hintMessage}`; // Skip if already logged. |
|
9
|
155 |
|
|
|
156 |
if (message in logged) { |
|
|
157 |
return; |
|
|
158 |
} |
|
|
159 |
/** |
|
|
160 |
* Fires whenever a deprecated feature is encountered |
|
|
161 |
* |
|
|
162 |
* @param {string} feature Name of the deprecated feature. |
|
|
163 |
* @param {?Object} options Personalisation options |
|
18
|
164 |
* @param {string} options.since Version in which the feature was deprecated. |
|
9
|
165 |
* @param {?string} options.version Version in which the feature will be removed. |
|
|
166 |
* @param {?string} options.alternative Feature to use instead |
|
|
167 |
* @param {?string} options.plugin Plugin name if it's a plugin feature |
|
|
168 |
* @param {?string} options.link Link to documentation |
|
|
169 |
* @param {?string} options.hint Additional message to help transition away from the deprecated feature. |
|
|
170 |
* @param {?string} message Message sent to console.warn |
|
|
171 |
*/ |
|
|
172 |
|
|
|
173 |
|
|
|
174 |
Object(_wordpress_hooks__WEBPACK_IMPORTED_MODULE_0__["doAction"])('deprecated', feature, options, message); // eslint-disable-next-line no-console |
|
|
175 |
|
|
|
176 |
console.warn(message); |
|
|
177 |
logged[message] = true; |
|
|
178 |
} |
|
18
|
179 |
/** @typedef {import('utility-types').NonUndefined<Parameters<typeof deprecated>[1]>} DeprecatedOptions */ |
|
9
|
180 |
|
|
|
181 |
|
|
18
|
182 |
/***/ }), |
|
|
183 |
|
|
|
184 |
/***/ "g56x": |
|
|
185 |
/***/ (function(module, exports) { |
|
|
186 |
|
|
|
187 |
(function() { module.exports = window["wp"]["hooks"]; }()); |
|
|
188 |
|
|
9
|
189 |
/***/ }) |
|
|
190 |
|
|
|
191 |
/******/ })["default"]; |