|
1 /* This Source Code Form is subject to the terms of the Mozilla Public |
|
2 * License, v. 2.0. If a copy of the MPL was not distributed with this |
|
3 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ |
|
4 |
|
5 "use strict"; |
|
6 |
|
7 module.metadata = { |
|
8 "stability": "experimental" |
|
9 }; |
|
10 |
|
11 const { get, format } = require("../console/traceback"); |
|
12 const { get: getPref } = require("../preferences/service"); |
|
13 const PREFERENCE = "devtools.errorconsole.deprecation_warnings"; |
|
14 |
|
15 function deprecateUsage(msg) { |
|
16 // Print caller stacktrace in order to help figuring out which code |
|
17 // does use deprecated thing |
|
18 let stack = get().slice(2); |
|
19 |
|
20 if (getPref(PREFERENCE)) |
|
21 console.error("DEPRECATED: " + msg + "\n" + format(stack)); |
|
22 } |
|
23 exports.deprecateUsage = deprecateUsage; |
|
24 |
|
25 function deprecateFunction(fun, msg) { |
|
26 return function deprecated() { |
|
27 deprecateUsage(msg); |
|
28 return fun.apply(this, arguments); |
|
29 }; |
|
30 } |
|
31 exports.deprecateFunction = deprecateFunction; |
|
32 |
|
33 function deprecateEvent(fun, msg, evtTypes) { |
|
34 return function deprecateEvent(evtType) { |
|
35 if (evtTypes.indexOf(evtType) >= 0) |
|
36 deprecateUsage(msg); |
|
37 return fun.apply(this, arguments); |
|
38 }; |
|
39 } |
|
40 exports.deprecateEvent = deprecateEvent; |