File: README.md

package info (click to toggle)
node-get-func-name 2.0.0%2Bdfsg-1.1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 76 kB
  • sloc: javascript: 19; makefile: 8; sh: 2
file content (123 lines) | stat: -rw-r--r-- 3,161 bytes parent folder | download | duplicates (16)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
<h1 align=center>
  <a href="http://chaijs.com" title="Chai Documentation">
    <img alt="ChaiJS" src="http://chaijs.com/img/chai-logo.png"/>
    <br>
    get-func-name
  </a>
</h1>

<p align=center>
  Utility for getting a function's name for <a href="http://nodejs.org">node</a> and the browser.
</p>

<p align=center>
  <a href="./LICENSE">
    <img
      alt="license:mit"
      src="https://img.shields.io/badge/license-mit-green.svg?style=flat-square"
    />
  </a>
  <a href="https://github.com/chaijs/get-func-name/releases">
    <img
      alt="tag:?"
      src="https://img.shields.io/github/tag/chaijs/get-func-name.svg?style=flat-square"
    />
  </a>
  <a href="https://travis-ci.org/chaijs/get-func-name">
    <img
      alt="build:?"
      src="https://img.shields.io/travis/chaijs/get-func-name/master.svg?style=flat-square"
    />
  </a>
  <a href="https://coveralls.io/r/chaijs/get-func-name">
    <img
      alt="coverage:?"
      src="https://img.shields.io/coveralls/chaijs/get-func-name/master.svg?style=flat-square"
    />
  </a>
  <a href="https://www.npmjs.com/packages/get-func-name">
    <img
      alt="npm:?"
      src="https://img.shields.io/npm/v/get-func-name.svg?style=flat-square"
    />
  </a>
  <a href="https://www.npmjs.com/packages/get-func-name">
    <img
      alt="dependencies:?"
      src="https://img.shields.io/npm/dm/get-func-name.svg?style=flat-square"
    />
  </a>
  <a href="">
    <img
      alt="devDependencies:?"
      src="https://img.shields.io/david/chaijs/get-func-name.svg?style=flat-square"
    />
  </a>
  <br/>
  <a href="https://saucelabs.com/u/chaijs-get-func-name">
    <img
      alt="Selenium Test Status"
      src="https://saucelabs.com/browser-matrix/chaijs-get-func-name.svg"
    />
  </a>
  <br>
  <a href="https://chai-slack.herokuapp.com/">
    <img
      alt="Join the Slack chat"
      src="https://img.shields.io/badge/slack-join%20chat-E2206F.svg?style=flat-square"
    />
  </a>
  <a href="https://gitter.im/chaijs/chai">
    <img
      alt="Join the Gitter chat"
      src="https://img.shields.io/badge/gitter-join%20chat-D0104D.svg?style=flat-square"
    />
  </a>
</p>

## What is get-func-name?

This is a module to retrieve a function's name securely and consistently both in NodeJS and the browser.

## Installation

### Node.js

`get-func-name` is available on [npm](http://npmjs.org). To install it, type:

    $ npm install get-func-name

### Browsers

You can also use it within the browser; install via npm and use the `get-func-name.js` file found within the download. For example:

```html
<script src="./node_modules/get-func-name/get-func-name.js"></script>
```

## Usage

The module `get-func-name` exports the following method:

* `getFuncName(fn)` - Returns the name of a function.

```js
var getFuncName = require('get-func-name');
```

#### .getFuncName(fun)

```js
var getFuncName = require('get-func-name');

var unknownFunction = function myCoolFunction(word) {
   return word + 'is cool'; 
};

var anonymousFunction = (function () {
    return function () {};
}());

getFuncName(unknownFunction) // 'myCoolFunction'
getFuncName(anonymousFunction) // ''
```