deprecate
Mark methods as deprecated and warn the user when they're called
Last updated a year ago by brianc .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install deprecate 
SYNC missed versions from official npm registry.

deprecate

Build Status

Mark a method as deprecated. Write a message to a stream the first time the deprecated method is called.

api

var deprecate = require('deprecate');

deprecate([string message1 [, string message2 [,...]]])

Call deprecate within a function you are deprecating. It will spit out all the messages to the console the first time and only the first time the method is called.

var deprecate = require('deprecate');

var someDeprecatedFunction = function() {
  deprecate('someDeprecatedFunction() is deprecated');
};

someDeprecatedFunction();
someDeprecatedFunction();
someDeprecatedFunction();
console.log('end');

//program output:

WARNING!!
someDeprecatedFunction() is deprecated


end

deprecate.color

Set to false to not output a color. Defaults to '\x1b[31;1m' which is red.

deprecate.silence

Set to false to do nothing at all when the deprecate method is called. Useful in tests of the library you're deprecating things within.

deprecate.stream

The stream to which output is written. Defaults to process.stderr

license

MIT

Current Tags

  • 1.1.1                                ...           latest (a year ago)

4 Versions

  • 1.1.1                                ...           a year ago
  • 1.1.0                                ...           2 years ago
  • 1.0.0                                ...           4 years ago
  • 0.1.0                                ...           7 years ago
Maintainers (1)
Downloads
Today 878
This Week 5,046
This Month 9,052
Last Day 1,031
Last Week 5,797
Last Month 21,935
Dependencies (0)
None
Dev Dependencies (1)
Dependents (124)

Copyright 2014 - 2016 © taobao.org |