You’re reading the English version of this content since no translation exists yet for this locale. Help us translate this article!
The in
operator returns true
if the specified property is in the specified object or its prototype chain.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Syntax
prop in object
Parameters
prop
- A string or symbol representing a property name or array index (non-symbols will be coerced to strings).
object
- Object to check if it (or its prototype chain) contains the property with specified name.
Description
The following examples show some uses of the in
operator.
// Arrays var trees = ['redwood', 'bay', 'cedar', 'oak', 'maple']; 0 in trees // returns true 3 in trees // returns true 6 in trees // returns false 'bay' in trees // returns false (you must specify the index number, not the value at that index) 'length' in trees // returns true (length is an Array property) Symbol.iterator in trees // returns true (arrays are iterable, works only in ES2015+) // Predefined objects 'PI' in Math // returns true // Custom objects var mycar = {make: 'Honda', model: 'Accord', year: 1998}; 'make' in mycar // returns true 'model' in mycar // returns true
You must specify an object on the right side of the in
operator. For example, you can specify a string created with the String
constructor, but you cannot specify a string literal.
var color1 = new String('green'); 'length' in color1 // returns true var color2 = 'coral'; // generates an error (color2 is not a String object) 'length' in color2
Using in
with deleted or undefined properties
If you delete a property with the delete
operator, the in
operator returns false
for that property.
var mycar = {make: 'Honda', model: 'Accord', year: 1998}; delete mycar.make; 'make' in mycar; // returns false var trees = new Array('redwood', 'bay', 'cedar', 'oak', 'maple'); delete trees[3]; 3 in trees; // returns false
If you set a property to undefined
but do not delete it, the in
operator returns true for that property.
var mycar = {make: 'Honda', model: 'Accord', year: 1998}; mycar.make = undefined; 'make' in mycar; // returns true
var trees = new Array('redwood', 'bay', 'cedar', 'oak', 'maple'); trees[3] = undefined; 3 in trees; // returns true
Inherited properties
The in
operator returns true
for properties in the prototype chain. (If you want to check for only non-inherited properties, use Object.prototype.hasOwnProperty()
instead.)
'toString' in {}; // returns true
Specifications
Specification | Status | Comment |
---|---|---|
ECMAScript Latest Draft (ECMA-262) The definition of 'Relational Operators' in that specification. |
Draft | |
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Relational Operators' in that specification. |
Standard | |
ECMAScript 5.1 (ECMA-262) The definition of 'The in Operator' in that specification. |
Standard | |
ECMAScript 3rd Edition (ECMA-262) The definition of 'The in Operator' in that specification. |
Standard | Initial definition. Implemented in JavaScript 1.4. |
Browser compatibility
Desktop | Mobile | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
in | Chrome Full support 1 | Edge Full support 12 | Firefox Full support 1 | IE Full support 5.5 | Opera Full support Yes | Safari Full support Yes | WebView Android Full support 1 | Chrome Android Full support 18 | Firefox Android Full support 4 | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support 1.0 | nodejs Full support Yes |
Legend
- Full support
- Full support