# isBigInt > Test if a value is a [BigInt][mdn-bigint].
## Usage ```javascript var isBigInt = require( '@stdlib/assert/is-bigint' ); ``` #### isBigInt( value ) Tests if a value is a [`BigInt`][mdn-bigint]. ```javascript var BigInt = require( '@stdlib/bigint/ctor' ); var bool = isBigInt( BigInt( '1' ) ); // returns true bool = isBigInt( Object( BigInt( '1' ) ) ); // returns true ``` #### isBigInt.isPrimitive( value ) Tests if a `value` is a primitive [`BigInt`][mdn-bigint]. ```javascript var BigInt = require( '@stdlib/bigint/ctor' ); var bool = isBigInt.isPrimitive( BigInt( '1' ) ); // returns true bool = isBigInt.isPrimitive( Object( BigInt( '1' ) ) ); // returns false ``` #### isBigInt.isObject( value ) Tests if a `value` is a [`BigInt`][mdn-bigint] object. ```javascript var BigInt = require( '@stdlib/bigint/ctor' ); var bool = isBigInt.isObject( BigInt( '1' ) ); // returns false bool = isBigInt.isObject( Object( BigInt( '1' ) ) ); // returns true ```
## Examples ```javascript var hasBigIntSupport = require( '@stdlib/assert/has-bigint-support' ); var BigInt = require( '@stdlib/bigint/ctor' ); var isBigInt = require( '@stdlib/assert/is-bigint' ); var bool; if ( hasBigIntSupport() ) { bool = isBigInt( BigInt( '1' ) ); // returns true } else { console.log( 'Environment does not support BigInts.' ); } bool = isBigInt( 1 ); // returns false bool = isBigInt( '1' ); // returns false bool = isBigInt( {} ); // returns false bool = isBigInt( [] ); // returns false bool = isBigInt( null ); // returns false bool = isBigInt( void 0 ); // returns false bool = isBigInt( true ); // returns false bool = isBigInt( function foo() {} ); // returns false ```