# propertySymbols
> Return an array of an object's own [symbol][@stdlib/symbol/ctor] properties.
## Usage
```javascript
var propertySymbols = require( '@stdlib/utils/property-symbols' );
```
#### propertySymbols( obj )
Returns an `array` of an object's own [symbol][@stdlib/symbol/ctor].
```javascript
var symbols = propertySymbols( {} );
```
## Notes
- In contrast to the built-in `Object.getOwnPropertySymbols()`, if provided `null` or `undefined`, the function returns an empty `array`, rather than throwing an error.
## Examples
```javascript
var hasSymbolSupport = require( '@stdlib/assert/has-symbol-support' );
var Symbol = require( '@stdlib/symbol/ctor' );
var propertySymbols = require( '@stdlib/utils/property-symbols' );
function Foo() {
if ( hasSymbolSupport() ) {
this[ Symbol( 'beep' ) ] = 'boop';
}
return this;
}
Foo.prototype.foo = 'bar';
var obj = new Foo();
var symbols = propertySymbols( obj );
console.log( symbols );
```
[@stdlib/symbol/ctor]: https://www.npmjs.com/package/@stdlib/symbol-ctor