Gecko [ unitednationsplay.com ]

Name	Size	Permission	Date
test	[ DIR ]	drwxr-xr-x	2021-02-04 21:24
.lint	88 B	-rw-r--r--	2015-07-07 12:13
.npmignore	51 B	-rw-r--r--	2015-06-25 13:26
.travis.yml	204 B	-rw-r--r--	2016-05-17 12:54
CHANGES	1.85 KB	-rw-r--r--	2017-03-15 14:58
LICENSE	1.05 KB	-rw-r--r--	2015-06-25 13:26
README.md	2.08 KB	-rw-r--r--	2016-11-11 20:09
implement.js	210 B	-rw-r--r--	2015-06-25 13:26
index.js	96 B	-rw-r--r--	2015-12-11 16:17
is-implemented.js	474 B	-rw-r--r--	2016-05-17 12:54
is-native-implemented.js	166 B	-rw-r--r--	2016-10-18 13:44
is-symbol.js	254 B	-rw-r--r--	2016-05-17 12:54
package.json	1.81 KB	-rw-r--r--	2021-02-04 21:24
polyfill.js	4.97 KB	-rw-r--r--	2016-11-11 20:09
validate-symbol.js	181 B	-rw-r--r--	2015-12-11 16:19

Rename

# es6-symbol
## ECMAScript 6 Symbol polyfill

For more information about symbols see following links
- [Symbols in ECMAScript 6 by Axel Rauschmayer](http://www.2ality.com/2014/12/es6-symbols.html)
- [MDN Documentation](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol)
- [Specification](http://people.mozilla.org/~jorendorff/es6-draft.html#sec-symbol-constructor)

### Limitations

Underneath it uses real string property names which can easily be retrieved, however accidental collision with other property names is unlikely.

### Usage

If you'd like to use native version when it exists and fallback to [ponyfill](https://ponyfill.com) if it doesn't, use *es6-symbol* as following:

```javascript
var Symbol = require('es6-symbol');
```

If you want to make sure your environment implements `Symbol` globally, do:

```javascript
require('es6-symbol/implement');
```

If you strictly want to use polyfill even if native `Symbol` exists (hard to find a good reason for that), do:

```javascript
var Symbol = require('es6-symbol/polyfill');
```

#### API

Best is to refer to [specification](http://people.mozilla.org/~jorendorff/es6-draft.html#sec-symbol-objects). Still if you want quick look, follow examples:

```javascript
var Symbol = require('es6-symbol');

var symbol = Symbol('My custom symbol');
var x = {};

x[symbol] = 'foo';
console.log(x[symbol]); 'foo'

// Detect iterable:
var iterator, result;
if (possiblyIterable[Symbol.iterator]) {
  iterator = possiblyIterable[Symbol.iterator]();
  result = iterator.next();
  while(!result.done) {
    console.log(result.value);
    result = iterator.next();
  }
}
```

### Installation
#### NPM

In your project path:

$ npm install es6-symbol

##### Browser

To port it to Browser or any other (non CJS) environment, use your favorite CJS bundler. No favorite yet? Try: [Browserify](http://browserify.org/), [Webmake](https://github.com/medikoo/modules-webmake) or [Webpack](http://webpack.github.io/)

## Tests [![Build Status](https://travis-ci.org/medikoo/es6-symbol.png)](https://travis-ci.org/medikoo/es6-symbol)

$ npm test