https://github.com/TooTallNate/node-function-name

Set the "name" property of `Function` objects
https://github.com/TooTallNate/node-function-name

Last synced: 10 days ago
JSON representation

Set the "name" property of `Function` objects

• Host: GitHub
• URL: https://github.com/TooTallNate/node-function-name
• Owner: TooTallNate
• License: isc
• Created: 2012-10-03T02:48:18.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2017-03-25T18:45:59.000Z (over 7 years ago)
• Last Synced: 2024-11-02T04:02:34.507Z (12 days ago)
• Language: JavaScript
• Size: 10.7 KB
• Stars: 28
• Watchers: 3
• Forks: 6
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: History.md
  • License: LICENSE

Awesome Lists containing this project

README

        
node-function-name

==================

### Set the "name" property of `Function` objects

[![Build Status](https://travis-ci.org/TooTallNate/node-function-name.svg?branch=master)](http://travis-ci.org/TooTallNate/node-function-name)

Very simple module. Sets the non-writable `name` property of `Function`

objects. In older versions of node, this functionality is exposed internally to

V8, but not exposed to JavaScript, so a  native module is required. In newer

versions of node, function names can be redefined with `Object.defineProperty`,

which this module uses.

Note that unfortunately _only_ String values are allowed.

> **NOTE: For users of node prior to `[email protected]`**, you'll need to use an

alternate version of this module, `function-name@native`, which provides a C++

implementation.

Installation

------------

Install with `npm`:

``` bash

$ npm install function-name

```

Example

-------

``` js

var set = require('function-name');

function test () {

  throw new Error('blah');

}

console.log(test.name);

// "test"

// change the "name" property to 'foo'

set(test, 'foo');

console.log(test.name);

// "foo"

// spaces, and even usually illegal UTF8 chars, are allowed

set(test, '   ☃   ');

console.log(test.name);

// "   ☃   "

// the newly set "name" also appears in stack traces!

test();

// Error: blah

//     at    ☃    (/Users/nrajlich/node-function-name/t.js:4:9)

//     at Object. (/Users/nrajlich/node-function-name/t.js:23:1)

//     at Module._compile (module.js:449:26)

//     at Object.Module._extensions..js (module.js:467:10)

//     at Module.load (module.js:356:32)

//     at Function.Module._load (module.js:312:12)

//     at Module.runMain (module.js:492:10)

//     at process.startup.processNextTick.process._tickCallback (node.js:244:9)

```

That's it!