# isReadOnlyProperty
> Test if an object's own property is [read-only][@stdlib/utils/define-read-only-property].
## Usage
```javascript
var isReadOnlyProperty = require( '@stdlib/assert/is-read-only-property' );
```
#### isReadOnlyProperty( value, property )
Returns a `boolean` indicating if a `value` has a [read-only][@stdlib/utils/define-read-only-property] `property`.
```javascript
var defineProperty = require( '@stdlib/utils/define-property' );
var obj = {
'foo': 'bar'
};
defineProperty( obj, 'beep', {
'configurable': false,
'enumerable': false,
'writable': false,
'value': 'boop'
});
defineProperty( obj, 'accessor', {
'configurable': false,
'enumerable': true,
'get': function getter() {
return obj.foo;
}
});
var bool = isReadOnlyProperty( obj, 'foo' );
// returns false
bool = isReadOnlyProperty( obj, 'beep' );
// returns true
bool = isReadOnlyProperty( obj, 'accessor' );
// returns true
```
## Notes
- Value arguments other than `null` or `undefined` are coerced to `objects`.
```javascript
var bool = isReadOnlyProperty( 'beep', 'length' );
// returns true
```
- Property arguments are coerced to `strings`.
```javascript
var defineProperty = require( '@stdlib/utils/define-property' );
var obj = {};
defineProperty( obj, 'null', {
'configurable': false,
'enumerable': true,
'writable': false,
'value': true
});
var bool = isReadOnlyProperty( obj, null );
// returns true
```
## Examples
```javascript
var isReadOnlyProperty = require( '@stdlib/assert/is-read-only-property' );
var bool = isReadOnlyProperty( 'a', 'length' );
// returns true
bool = isReadOnlyProperty( { 'a': 'b' }, 'a' );
// returns false
bool = isReadOnlyProperty( [ 'a' ], 0 );
// returns false
bool = isReadOnlyProperty( { 'null': false }, null );
// returns false
bool = isReadOnlyProperty( { '[object Object]': false }, {} );
// returns false
bool = isReadOnlyProperty( {}, 'toString' );
// returns false
bool = isReadOnlyProperty( {}, 'hasOwnProperty' );
// returns false
bool = isReadOnlyProperty( null, 'a' );
// returns false
bool = isReadOnlyProperty( void 0, 'a' );
// returns false
```
[@stdlib/utils/define-read-only-property]: https://www.npmjs.com/package/@stdlib/utils-define-read-only-property