# BigInt
> [BigInt][mdn-bigint] factory.
## Usage
```javascript
var BigInt = require( '@stdlib/bigint/ctor' );
```
#### BigInt( value )
Returns a [`BigInt`][mdn-bigint] primitive.
```javascript
var v = BigInt( '1' );
// returns
```
TODO: document properties/methods
## Notes
- Unlike conventional constructors, the function does **not** support the `new` keyword.
- The function is only supported in environments which support [`BigInt`][mdn-bigint]. In non-supporting environments, the value is `undefined`.
## Examples
```javascript
var hasBigIntSupport = require( '@stdlib/assert/has-bigint-support' );
var BigInt = require( '@stdlib/bigint/ctor' );
var v;
if ( hasBigIntSupport() ) {
v = BigInt( '1' );
// Print the value type:
console.log( typeof v );
// => 'bigint'
// Serialize the BigInt as a string:
console.log( v.toString() );
// => '1'
} else {
console.log( 'Environment does not support BigInts.' );
}
```
[mdn-bigint]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt