mirror of
https://github.com/google/blockly.git
synced 2026-01-10 10:27:08 +01:00
51d9dad31f
* Reexport Blockly.utils.* modules from Blockly.utils * Update metadata (file sizes) again blockly_compressed.js has gotten too big for the second time this quarter. Update the expected file sizes for it so that tests will continue to pass.
41 lines
1.1 KiB
JavaScript
41 lines
1.1 KiB
JavaScript
/**
|
|
* @license
|
|
* Copyright 2020 Google LLC
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
/**
|
|
* @fileoverview Helper function for warning developers about deprecations.
|
|
* This method is not specific to Blockly.
|
|
* @author fenichel@google.com (Rachel Fenichel)
|
|
*/
|
|
'use strict';
|
|
|
|
/**
|
|
* @name Blockly.utils.deprecation
|
|
* @namespace
|
|
*/
|
|
goog.module('Blockly.utils.deprecation');
|
|
|
|
|
|
/**
|
|
* Warn developers that a function or property is deprecated.
|
|
* @param {string} name The name of the function or property.
|
|
* @param {string} deprecationDate The date of deprecation.
|
|
* Prefer 'month yyyy' or 'quarter yyyy' format.
|
|
* @param {string} deletionDate The date of deletion, in the same format as the
|
|
* deprecation date.
|
|
* @param {string=} opt_use The name of a function or property to use instead,
|
|
* if any.
|
|
*/
|
|
const warn = function(name, deprecationDate, deletionDate, opt_use) {
|
|
let msg = name + ' was deprecated on ' + deprecationDate +
|
|
' and will be deleted on ' + deletionDate + '.';
|
|
if (opt_use) {
|
|
msg += '\nUse ' + opt_use + ' instead.';
|
|
}
|
|
console.warn(msg);
|
|
};
|
|
/** @package */
|
|
exports.warn = warn;
|