enmi-conf.org: comparison wp/wp-includes/js/dist/deprecated.js

Mercurial Mercurial > enmi-conf.org / comparison

summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help

wp/wp-includes/js/dist/deprecated.js

changeset 18	be944660c56a
parent 16	a86126ab1dd4
child 19	3d72ae0968f4

equal deleted inserted replaced

-:34716fd837a4
+:be944660c56a
 /******/ 	// __webpack_public_path__
 /******/ 	__webpack_require__.p = "";
 /******/
 /******/
 /******/ 	// Load entry module and return exports
-/******/ 	return __webpack_require__(__webpack_require__.s = 418);
+/******/ 	return __webpack_require__(__webpack_require__.s = "+BeG");
 /******/ })
 /************************************************************************/
 /******/ ({
-/***/ 32:
+/***/ "+BeG":
-/***/ (function(module, exports) {
-(function() { module.exports = this["wp"]["hooks"]; }());
-/***/ }),
-/***/ 418:
 /***/ (function(module, __webpack_exports__, __webpack_require__) {
 "use strict";
 __webpack_require__.r(__webpack_exports__);
 /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "logged", function() { return logged; });
 /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "default", function() { return deprecated; });
-/* harmony import */ var _wordpress_hooks__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(32);
+/* harmony import */ var _wordpress_hooks__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__("g56x");
 /* harmony import */ var _wordpress_hooks__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(_wordpress_hooks__WEBPACK_IMPORTED_MODULE_0__);
 /**
 * WordPress dependencies
 */
 /**
 * Object map tracking messages which have been logged, for use in ensuring a
 * message is only logged once.
 *
-* @type {Object}
+* @type {Record<string, true | undefined>}
 */
-var logged = Object.create(null);
+const logged = Object.create(null);
 /**
 * Logs a message to notify developers about a deprecated feature.
 *
-* @param {string}  feature             Name of the deprecated feature.
+* @param {string} feature               Name of the deprecated feature.
-* @param {?Object} options             Personalisation options
+* @param {Object} [options]             Personalisation options
-* @param {?string} options.version     Version in which the feature will be removed.
+* @param {string} [options.since]       Version in which the feature was deprecated.
-* @param {?string} options.alternative Feature to use instead
+* @param {string} [options.version]     Version in which the feature will be removed.
-* @param {?string} options.plugin      Plugin name if it's a plugin feature
+* @param {string} [options.alternative] Feature to use instead
-* @param {?string} options.link        Link to documentation
+* @param {string} [options.plugin]      Plugin name if it's a plugin feature
-* @param {?string} options.hint        Additional message to help transition away from the deprecated 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', {
-* 	version: 'the future',
+* 	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 and will be removed from the earth in the future. Please use vegetables instead. Note: 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) {
+function deprecated(feature, options = {}) {
-var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+const {
-var version = options.version,
+since,
-alternative = options.alternative,
+version,
-plugin = options.plugin,
+alternative,
-link = options.link,
+plugin,
-hint = options.hint;
+link,
-var pluginMessage = plugin ? " from ".concat(plugin) : '';
+hint
-var versionMessage = version ? " and will be removed".concat(pluginMessage, " in version ").concat(version) : '';
+} = options;
-var useInsteadMessage = alternative ? " Please use ".concat(alternative, " instead.") : '';
+const pluginMessage = plugin ? ` from ${plugin}` : '';
-var linkMessage = link ? " See: ".concat(link) : '';
+const sinceMessage = since ? ` since version ${since}` : '';
-var hintMessage = hint ? " Note: ".concat(hint) : '';
+const versionMessage = version ? ` and will be removed${pluginMessage} in version ${version}` : '';
-var message = "".concat(feature, " is deprecated").concat(versionMessage, ".").concat(useInsteadMessage).concat(linkMessage).concat(hintMessage); // Skip if already logged.
+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.
 Object(_wordpress_hooks__WEBPACK_IMPORTED_MODULE_0__["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 */
+/***/ }),
+/***/ "g56x":
+/***/ (function(module, exports) {
+(function() { module.exports = window["wp"]["hooks"]; }());
 /***/ })
 /******/ })["default"];

enmi-conf.org