123 lines
4.6 KiB
JavaScript
123 lines
4.6 KiB
JavaScript
/******/ (() => { // webpackBootstrap
|
|
/******/ "use strict";
|
|
/******/ // The require scope
|
|
/******/ var __webpack_require__ = {};
|
|
/******/
|
|
/************************************************************************/
|
|
/******/ /* webpack/runtime/define property getters */
|
|
/******/ (() => {
|
|
/******/ // define getter functions for harmony exports
|
|
/******/ __webpack_require__.d = (exports, definition) => {
|
|
/******/ for(var key in definition) {
|
|
/******/ if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {
|
|
/******/ Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });
|
|
/******/ }
|
|
/******/ }
|
|
/******/ };
|
|
/******/ })();
|
|
/******/
|
|
/******/ /* webpack/runtime/hasOwnProperty shorthand */
|
|
/******/ (() => {
|
|
/******/ __webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))
|
|
/******/ })();
|
|
/******/
|
|
/************************************************************************/
|
|
var __webpack_exports__ = {};
|
|
|
|
// EXPORTS
|
|
__webpack_require__.d(__webpack_exports__, {
|
|
"default": () => (/* binding */ deprecated)
|
|
});
|
|
|
|
// UNUSED EXPORTS: logged
|
|
|
|
;// CONCATENATED MODULE: external ["wp","hooks"]
|
|
const external_wp_hooks_namespaceObject = window["wp"]["hooks"];
|
|
;// CONCATENATED MODULE: ./node_modules/@wordpress/deprecated/build-module/index.js
|
|
/**
|
|
* WordPress dependencies
|
|
*/
|
|
|
|
|
|
/**
|
|
* Object map tracking messages which have been logged, for use in ensuring a
|
|
* message is only logged once.
|
|
*
|
|
* @type {Record<string, true | undefined>}
|
|
*/
|
|
const logged = Object.create(null);
|
|
|
|
/**
|
|
* Logs a message to notify developers about a deprecated feature.
|
|
*
|
|
* @param {string} feature Name of the deprecated feature.
|
|
* @param {Object} [options] Personalisation options
|
|
* @param {string} [options.since] Version in which the feature was deprecated.
|
|
* @param {string} [options.version] Version in which the feature will be removed.
|
|
* @param {string} [options.alternative] Feature to use instead
|
|
* @param {string} [options.plugin] Plugin name if it's a plugin feature
|
|
* @param {string} [options.link] Link to documentation
|
|
* @param {string} [options.hint] Additional message to help transition away from the deprecated feature.
|
|
*
|
|
* @example
|
|
* ```js
|
|
* import deprecated from '@wordpress/deprecated';
|
|
*
|
|
* deprecated( 'Eating meat', {
|
|
* since: '2019.01.01'
|
|
* version: '2020.01.01',
|
|
* alternative: 'vegetables',
|
|
* plugin: 'the earth',
|
|
* hint: 'You may find it beneficial to transition gradually.',
|
|
* } );
|
|
*
|
|
* // 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.'
|
|
* ```
|
|
*/
|
|
function deprecated(feature, options = {}) {
|
|
const {
|
|
since,
|
|
version,
|
|
alternative,
|
|
plugin,
|
|
link,
|
|
hint
|
|
} = options;
|
|
const pluginMessage = plugin ? ` from ${plugin}` : '';
|
|
const sinceMessage = since ? ` since version ${since}` : '';
|
|
const versionMessage = version ? ` and will be removed${pluginMessage} in version ${version}` : '';
|
|
const useInsteadMessage = alternative ? ` Please use ${alternative} instead.` : '';
|
|
const linkMessage = link ? ` See: ${link}` : '';
|
|
const hintMessage = hint ? ` Note: ${hint}` : '';
|
|
const message = `${feature} is deprecated${sinceMessage}${versionMessage}.${useInsteadMessage}${linkMessage}${hintMessage}`;
|
|
|
|
// Skip if already logged.
|
|
if (message in logged) {
|
|
return;
|
|
}
|
|
|
|
/**
|
|
* Fires whenever a deprecated feature is encountered
|
|
*
|
|
* @param {string} feature Name of the deprecated feature.
|
|
* @param {?Object} options Personalisation options
|
|
* @param {string} options.since Version in which the feature was deprecated.
|
|
* @param {?string} options.version Version in which the feature will be removed.
|
|
* @param {?string} options.alternative Feature to use instead
|
|
* @param {?string} options.plugin Plugin name if it's a plugin feature
|
|
* @param {?string} options.link Link to documentation
|
|
* @param {?string} options.hint Additional message to help transition away from the deprecated feature.
|
|
* @param {?string} message Message sent to console.warn
|
|
*/
|
|
(0,external_wp_hooks_namespaceObject.doAction)('deprecated', feature, options, message);
|
|
|
|
// eslint-disable-next-line no-console
|
|
console.warn(message);
|
|
logged[message] = true;
|
|
}
|
|
|
|
/** @typedef {import('utility-types').NonUndefined<Parameters<typeof deprecated>[1]>} DeprecatedOptions */
|
|
|
|
(window.wp = window.wp || {}).deprecated = __webpack_exports__["default"];
|
|
/******/ })()
|
|
; |