## Chapter 4 # Data Structures: Objects and Arrays > [](http://eloquentjavascript.net/04_data.html#p_3DGxnMhaad)On two occasions I have been asked, ‘Pray, Mr. Babbage, if you put into the machine wrong figures, will the right answers come out?’ [...] I am not able rightly to apprehend the kind of confusion of ideas that could provoke such a question. > > Charles Babbage, Passages from the Life of a Philosopher (1864) [](http://eloquentjavascript.net/04_data.html#p_j/UjCN3npi)Numbers, Booleans, and strings are the bricks that data structures are built from. But you can’t make much of a house out of a single brick. *Objects* allow us to group values—including other objects—together and thus build more complex structures. [](http://eloquentjavascript.net/04_data.html#p_TT9r8Cr1W0)The programs we have built so far have been seriously hampered by the fact that they were operating only on simple data types. This chapter will add a basic understanding of data structures to your toolkit. By the end of it, you’ll know enough to start writing some useful programs. [](http://eloquentjavascript.net/04_data.html#p_vL8agXHSiL)The chapter will work through a more or less realistic programming example, introducing concepts as they apply to the problem at hand. The example code will often build on functions and variables that were introduced earlier in the text. ## [](http://eloquentjavascript.net/04_data.html#h_NvjtahQLlw)The weresquirrel [](http://eloquentjavascript.net/04_data.html#p_2uQlDOT3CH)Every now and then, usually between eight and ten in the evening, Jacques finds himself transforming into a small furry rodent with a bushy tail. [](http://eloquentjavascript.net/04_data.html#p_EIDMzKWaqr)On one hand, Jacques is quite glad that he doesn’t have classic lycanthropy. Turning into a squirrel tends to cause fewer problems than turning into a wolf. Instead of having to worry about accidentally eating the neighbor (*that* would be awkward), he worries about being eaten by the neighbor’s cat. After two occasions where he woke up on a precariously thin branch in the crown of an oak, naked and disoriented, he has taken to locking the doors and windows of his room at night and putting a few walnuts on the floor to keep himself busy.  [](http://eloquentjavascript.net/04_data.html#p_mMWZqiA+i1)That takes care of the cat and oak problems. But Jacques still suffers from his condition. The irregular occurrences of the transformation make him suspect that they might be triggered by something. For a while, he believed that it happened only on days when he had touched trees. So he stopped touching trees entirely and even avoided going near them. But the problem persisted. [](http://eloquentjavascript.net/04_data.html#p_I4RF6opRCC)Switching to a more scientific approach, Jacques intends to start keeping a daily log of everything he did that day and whether he changed form. With this data he hopes to narrow down the conditions that trigger the transformations. [](http://eloquentjavascript.net/04_data.html#p_WERwFzJu93)The first thing he does is design a data structure to store this information. ## [](http://eloquentjavascript.net/04_data.html#h_HjL/otjEJn)Data sets [](http://eloquentjavascript.net/04_data.html#p_HFLfyQFSDp)To work with a chunk of digital data, we’ll first have to find a way to represent it in our machine’s memory. Say, as a simple example, that we want to represent a collection of numbers: 2, 3, 5, 7, and 11. [](http://eloquentjavascript.net/04_data.html#p_cnzv4pg+Wz)We could get creative with strings—after all, strings can be any length, so we can put a lot of data into them—and use `"2 3 5 7 11"` as our representation. But this is awkward. You’d have to somehow extract the digits and convert them back to numbers to access them. [](http://eloquentjavascript.net/04_data.html#p_/aFILq7bDn)Fortunately, JavaScript provides a data type specifically for storing sequences of values. It is called an *array* and is written as a list of values between square brackets, separated by commas. ~~~ var listOfNumbers = [2, 3, 5, 7, 11]; console.log(listOfNumbers[1]); // → 3 console.log(listOfNumbers[1 - 1]); // → 2 ~~~ [](http://eloquentjavascript.net/04_data.html#p_xu5bhsrvS2)The notation for getting at the elements inside an array also uses square brackets. A pair of square brackets immediately after an expression, with another expression inside of them, will look up the element in the left-hand expression that corresponds to the *index* given by the expression in the brackets. [](http://eloquentjavascript.net/04_data.html#p_i4f1iEZJFW)The first index of an array is zero, not one. So the first element can be read with`listOfNumbers[0]`. If you don’t have a programming background, this convention might take some getting used to. But zero-based counting has a long tradition in technology, and as long as this convention is followed consistently (which it is, in JavaScript), it works well. ## [](http://eloquentjavascript.net/04_data.html#h_vGyI2y8HA6)Properties [](http://eloquentjavascript.net/04_data.html#p_N/KiJ+p6sy)We’ve seen a few suspicious-looking expressions like `myString.length` (to get the length of a string) and `Math.max` (the maximum function) in past examples. These are expressions that access a *property* of some value. In the first case, we access the `length` property of the value in `myString`. In the second, we access the property named `max` in the `Math` object (which is a collection of mathematics-related values and functions). [](http://eloquentjavascript.net/04_data.html#p_dTOk+Nu/lR)Almost all JavaScript values have properties. The exceptions are `null` and`undefined`. If you try to access a property on one of these nonvalues, you get an error. ~~~ null.length; // → TypeError: Cannot read property 'length' of null ~~~ [](http://eloquentjavascript.net/04_data.html#p_etK6gD7WXZ)The two most common ways to access properties in JavaScript are with a dot and with square brackets. Both `value.x` and `value[x]` access a property on`value`—but not necessarily the same property. The difference is in how `x` is interpreted. When using a dot, the part after the dot must be a valid variable name, and it directly names the property. When using square brackets, the expression between the brackets is *evaluated* to get the property name. Whereas `value.x` fetches the property of `value` named “x”, `value[x]` tries to evaluate the expression `x` and uses the result as the property name. [](http://eloquentjavascript.net/04_data.html#p_tcrruPP6JD)So if you know that the property you are interested in is called “length”, you say`value.length`. If you want to extract the property named by the value held in the variable `i`, you say `value[i]`. And because property names can be any string, if you want to access a property named “2” or “John Doe”, you must use square brackets: `value[2]` or `value["John Doe"]`. This is the case even though you know the precise name of the property in advance, because neither “2” nor “John Doe” is a valid variable name and so cannot be accessed through dot notation. [](http://eloquentjavascript.net/04_data.html#p_d0vwHo1UJ1)The elements in an array are stored in properties. Because the names of these properties are numbers and we often need to get their name from a variable, we have to use the bracket syntax to access them. The `length` property of an array tells us how many elements it contains. This property name is a valid variable name, and we know its name in advance, so to find the length of an array, you typically write `array.length` because that is easier to write than`array["length"]`. ## [](http://eloquentjavascript.net/04_data.html#h_fkrGgDyRWc)Methods [](http://eloquentjavascript.net/04_data.html#p_1Q3NM3X6G3)Both string and array objects contain, in addition to the `length` property, a number of properties that refer to function values. ~~~ var doh = "Doh"; console.log(typeof doh.toUpperCase); // → function console.log(doh.toUpperCase()); // → DOH ~~~ [](http://eloquentjavascript.net/04_data.html#p_EmYOwg/BO9)Every string has a `toUpperCase` property. When called, it will return a copy of the string, in which all letters have been converted to uppercase. There is also`toLowerCase`. You can guess what that does. [](http://eloquentjavascript.net/04_data.html#p_lNzNM3PoU4)Interestingly, even though the call to `toUpperCase` does not pass any arguments, the function somehow has access to the string `"Doh"`, the value whose property we called. How this works is described in [Chapter 6](http://eloquentjavascript.net/06_object.html#obj_methods). [](http://eloquentjavascript.net/04_data.html#p_gvO150ZgOs)Properties that contain functions are generally called *methods* of the value they belong to. As in, “`toUpperCase` is a method of a string”. [](http://eloquentjavascript.net/04_data.html#p_FALcpD+CSn)This example demonstrates some methods that array objects have: ~~~ var mack = []; mack.push("Mack"); mack.push("the", "Knife"); console.log(mack); // → ["Mack", "the", "Knife"] console.log(mack.join(" ")); // → Mack the Knife console.log(mack.pop()); // → Knife console.log(mack); // → ["Mack", "the"] ~~~ [](http://eloquentjavascript.net/04_data.html#p_du5uQ2te7B)The `push` method can be used to add values to the end of an array. The `pop`method does the opposite: it removes the value at the end of the array and returns it. An array of strings can be flattened to a single string with the `join`method. The argument given to `join` determines the text that is glued between the array’s elements. ## [](http://eloquentjavascript.net/04_data.html#h_cqg63Sxe3o)Objects [](http://eloquentjavascript.net/04_data.html#p_D8cm1kz0P8)Back to the weresquirrel. A set of daily log entries can be represented as an array. But the entries do not consist of just a number or a string—each entry needs to store a list of activities and a Boolean value that indicates whether Jacques turned into a squirrel. Ideally, we would like to group these values together into a single value and then put these grouped values into an array of log entries. [](http://eloquentjavascript.net/04_data.html#p_aZEa6qyMum)Values of the type *object* are arbitrary collections of properties, and we can add or remove these properties as we please. One way to create an object is by using a curly brace notation. ~~~ var day1 = { squirrel: false, events: ["work", "touched tree", "pizza", "running", "television"] }; console.log(day1.squirrel); // → false console.log(day1.wolf); // → undefined day1.wolf = false; console.log(day1.wolf); // → false ~~~ [](http://eloquentjavascript.net/04_data.html#p_hxTCt8woA9)Inside the curly braces, we can give a list of properties separated by commas. Each property is written as a name, followed by a colon, followed by an expression that provides a value for the property. Spaces and line breaks are not significant. When an object spans multiple lines, indenting it like in the previous example improves readability. Properties whose names are not valid variable names or valid numbers have to be quoted. ~~~ var descriptions = { work: "Went to work", "touched tree": "Touched a tree" }; ~~~ [](http://eloquentjavascript.net/04_data.html#p_muKvKdGc+G)This means that curly braces have *two* meanings in JavaScript. At the start of a statement, they start a block of statements. In any other position, they describe an object. Fortunately, it is almost never useful to start a statement with a curly-brace object, and in typical programs, there is no ambiguity between these two uses. [](http://eloquentjavascript.net/04_data.html#p_04jR2jxhZ9)Reading a property that doesn’t exist will produce the value `undefined`, which happens the first time we try to read the `wolf` property in the previous example. [](http://eloquentjavascript.net/04_data.html#p_oxubJ4TSX5)It is possible to assign a value to a property expression with the `=` operator. This will replace the property’s value if it already existed or create a new property on the object if it didn’t. [](http://eloquentjavascript.net/04_data.html#p_FolCMJfte3)To briefly return to our tentacle model of variable bindings—property bindings are similar. They *grasp* values, but other variables and properties might be holding onto those same values. You may think of objects as octopuses with any number of tentacles, each of which has a name inscribed on it.  [](http://eloquentjavascript.net/04_data.html#p_0r+HcrZzZJ)The `delete` operator cuts off a tentacle from such an octopus. It is a unary operator that, when applied to a property access expression, will remove the named property from the object. This is not a common thing to do, but it is possible. ~~~ var anObject = {left: 1, right: 2}; console.log(anObject.left); // → 1 delete anObject.left; console.log(anObject.left); // → undefined console.log("left" in anObject); // → false console.log("right" in anObject); // → true ~~~ [](http://eloquentjavascript.net/04_data.html#p_CuN7Z7VCcF)The binary `in` operator, when applied to a string and an object, returns a Boolean value that indicates whether that object has that property. The difference between setting a property to `undefined` and actually deleting it is that, in the first case, the object still *has* the property (it just doesn’t have a very interesting value), whereas in the second case the property is no longer present and `in` will return `false`. [](http://eloquentjavascript.net/04_data.html#p_Rl8msr9DUz)Arrays, then, are just a kind of object specialized for storing sequences of things. If you evaluate `typeof [1, 2]`, this produces `"object"`. You can see them as long, flat octopuses with all their arms in a neat row, labeled with numbers.  [](http://eloquentjavascript.net/04_data.html#p_/qn/Ibmvdm)So we can represent Jacques’ journal as an array of objects. ~~~ var journal = [ {events: ["work", "touched tree", "pizza", "running", "television"], squirrel: false}, {events: ["work", "ice cream", "cauliflower", "lasagna", "touched tree", "brushed teeth"], squirrel: false}, {events: ["weekend", "cycling", "break", "peanuts", "beer"], squirrel: true}, /* and so on... */ ]; ~~~ ## [](http://eloquentjavascript.net/04_data.html#h_C3n45IkMhg)Mutability [](http://eloquentjavascript.net/04_data.html#p_HZ50qDRWmj)We will get to actual programming *real* soon now. But first, there’s one last piece of theory to understand. [](http://eloquentjavascript.net/04_data.html#p_zvnMtK4gE8)We’ve seen that object values can be modified. The types of values discussed in earlier chapters, such as numbers, strings, and Booleans, are all *immutable*—it is impossible to change an existing value of those types. You can combine them and derive new values from them, but when you take a specific string value, that value will always remain the same. The text inside it cannot be changed. If you have reference to a string that contains `"cat"`, it is not possible for other code to change a character in *that* string to make it spell `"rat"`. [](http://eloquentjavascript.net/04_data.html#p_pwnQ1xNUOh)With objects, on the other hand, the content of a value *can* be modified by changing its properties. [](http://eloquentjavascript.net/04_data.html#p_fVZ1xXAqW5)When we have two numbers, 120 and 120, we can consider them precisely the same number, whether or not they refer to the same physical bits. But with objects, there is a difference between having two references to the same object and having two different objects that contain the same properties. Consider the following code: ~~~ var object1 = {value: 10}; var object2 = object1; var object3 = {value: 10}; console.log(object1 == object2); // → true console.log(object1 == object3); // → false object1.value = 15; console.log(object2.value); // → 15 console.log(object3.value); // → 10 ~~~ [](http://eloquentjavascript.net/04_data.html#p_RhD+qPB3F0)The `object1` and `object2` variables grasp the *same* object, which is why changing `object1` also changes the value of `object2`. The variable `object3`points to a different object, which initially contains the same properties as`object1` but lives a separate life. [](http://eloquentjavascript.net/04_data.html#p_S6PAaKQoFH)JavaScript’s `==` operator, when comparing objects, will return `true` only if both objects are precisely the same value. Comparing different objects will return `false`, even if they have identical contents. There is no “deep” comparison operation built into JavaScript, which looks at object’s contents, but it is possible to write it yourself (which will be one of the [exercises](http://eloquentjavascript.net/04_data.html#exercise_deep_compare) at the end of this chapter). ## [](http://eloquentjavascript.net/04_data.html#h_+q4Ck0/tFV)The lycanthrope’s log [](http://eloquentjavascript.net/04_data.html#p_z1vPsL0dwv)So Jacques starts up his JavaScript interpreter and sets up the environment he needs to keep his journal. ~~~ var journal = []; function addEntry(events, didITurnIntoASquirrel) { journal.push({ events: events, squirrel: didITurnIntoASquirrel }); } ~~~ [](http://eloquentjavascript.net/04_data.html#p_6o6Q7TaG26)And then, every evening at ten—or sometimes the next morning, after climbing down from the top shelf of his bookcase—he records the day. ~~~ addEntry(["work", "touched tree", "pizza", "running", "television"], false); addEntry(["work", "ice cream", "cauliflower", "lasagna", "touched tree", "brushed teeth"], false); addEntry(["weekend", "cycling", "break", "peanuts", "beer"], true); ~~~ [](http://eloquentjavascript.net/04_data.html#p_+Ih1dpMwEH)Once he has enough data points, he intends to compute the correlation between his squirrelification and each of the day’s events and ideally learn something useful from those correlations. [](http://eloquentjavascript.net/04_data.html#p_EedDVNQ30H)*Correlation* is a measure of dependence between variables (“variables” in the statistical sense, not the JavaScript sense). It is usually expressed as a coefficient that ranges from -1 to 1\. Zero correlation means the variables are not related, whereas a correlation of one indicates that the two are perfectly related—if you know one, you also know the other. Negative one also means that the variables are perfectly related but that they are opposites—when one is true, the other is false. [](http://eloquentjavascript.net/04_data.html#p_4Rv6gGntx7)For binary (Boolean) variables, the *phi* coefficient (*ϕ*) provides a good measure of correlation and is relatively easy to compute. To compute *ϕ*, we need a table*n* that contains the number of times the various combinations of the two variables were observed. For example, we could take the event of eating pizza and put that in a table like this:  [](http://eloquentjavascript.net/04_data.html#p_82L/EowL1c)*ϕ* can be computed using the following formula, where *n* refers to the table: | *ϕ* = | n11n00 - n10n01 √ n1•n0•n•1n•0 | [](http://eloquentjavascript.net/04_data.html#p_WPl/XNNv2K)The notation *n*01 indicates the number of measurements where the first variable (squirrelness) is false (0) and the second variable (pizza) is true (1). In this example, *n*01 is 9. [](http://eloquentjavascript.net/04_data.html#p_pweIXp0GRF)The value *n*1• refers to the sum of all measurements where the first variable is true, which is 5 in the example table. Likewise, *n*•0 refers to the sum of the measurements where the second variable is false. [](http://eloquentjavascript.net/04_data.html#p_ACMn7uvFzz)So for the pizza table, the part above the division line (the dividend) would be 1×76 - 4×9 = 40, and the part below it (the divisor) would be the square root of 5×85×10×80, or √340000\. This comes out to *ϕ* ≈ 0.069, which is tiny. Eating pizza does not appear to have influence on the transformations. ## [](http://eloquentjavascript.net/04_data.html#h_YwedOm6SqZ)Computing correlation [](http://eloquentjavascript.net/04_data.html#p_jn2nhCXEpR)We can represent a two-by-two table in JavaScript with a four-element array (`[76, 9, 4, 1]`). We could also use other representations, such as an array containing two two-element arrays (`[[76, 9], [4, 1]]`) or an object with property names like `"11"` and `"01"`, but the flat array is simple and makes the expressions that access the table pleasantly short. We’ll interpret the indices to the array as two-bit binary number, where the leftmost (most significant) digit refers to the squirrel variable and the rightmost (least significant) digit refers to the event variable. For example, the binary number `10` refers to the case where Jacques did turn into a squirrel, but the event (say, "pizza") didn’t occur. This happened four times. And since binary `10` is 2 in decimal notation, we will store this number at index 2 of the array. [](http://eloquentjavascript.net/04_data.html#p_napfsNS5sk)This is the function that computes the *ϕ* coefficient from such an array: ~~~ function phi(table) { return (table[3] * table[0] - table[2] * table[1]) / Math.sqrt((table[2] + table[3]) * (table[0] + table[1]) * (table[1] + table[3]) * (table[0] + table[2])); } console.log(phi([76, 9, 4, 1])); // → 0.068599434 ~~~ [](http://eloquentjavascript.net/04_data.html#p_25QRmcB8ci)This is simply a direct translation of the *ϕ* formula into JavaScript. `Math.sqrt`is the square root function, as provided by the `Math` object in a standard JavaScript environment. We have to sum two fields from the table to get fields like n1• because the sums of rows or columns are not stored directly in our data structure. [](http://eloquentjavascript.net/04_data.html#p_0u/DATumDu)Jacques kept his journal for three months. The resulting data set is available in the coding sandbox for this chapter, where it is stored in the `JOURNAL` variable, and in a downloadable [file](http://eloquentjavascript.net/code/jacques_journal.js). [](http://eloquentjavascript.net/04_data.html#p_sM+4QT8FKs)To extract a two-by-two table for a specific event from this journal, we must loop over all the entries and tally up how many times the event occurs in relation to squirrel transformations. ~~~ function hasEvent(event, entry) { return entry.events.indexOf(event) != -1; } function tableFor(event, journal) { var table = [0, 0, 0, 0]; for (var i = 0; i < journal.length; i++) { var entry = journal[i], index = 0; if (hasEvent(event, entry)) index += 1; if (entry.squirrel) index += 2; table[index] += 1; } return table; } console.log(tableFor("pizza", JOURNAL)); // → [76, 9, 4, 1] ~~~ [](http://eloquentjavascript.net/04_data.html#p_3pgyJn7mEy)The `hasEvent` function tests whether an entry contains a given event. Arrays have an `indexOf` method that tries to find a given value (in this case, the event name) in the array and returns the index at which it was found or -1 if it wasn’t found. So if the call to `indexOf` doesn’t return -1, then we know the event was found in the entry. [](http://eloquentjavascript.net/04_data.html#p_6jCcm4ltfJ)The body of the loop in `tableFor` figures out which box in the table each journal entry falls into by checking whether the entry contains the specific event it’s interested in and whether the event happens alongside a squirrel incident. The loop then adds one to the number in the array that corresponds to this box on the table. [](http://eloquentjavascript.net/04_data.html#p_PId7X0fpkS)We now have the tools we need to compute individual correlations. The only step remaining is to find a correlation for every type of event that was recorded and see whether anything stands out. But how should we store these correlations once we compute them? ## [](http://eloquentjavascript.net/04_data.html#h_mrW9RQxlGk)Objects as maps [](http://eloquentjavascript.net/04_data.html#p_IdpwDMsKm8)One possible way is to store all the correlations in an array, using objects with`name` and `value` properties. But that makes looking up the correlation for a given event somewhat cumbersome: you’d have to loop over the whole array to find the object with the right `name`. We could wrap this lookup process in a function, but we would still be writing more code, and the computer would be doing more work than necessary. [](http://eloquentjavascript.net/04_data.html#p_cZSsd9wDlN)A better way is to use object properties named after the event types. We can use the square bracket access notation to create and read the properties and can use the `in` operator to test whether a given property exists. ~~~ var map = {}; function storePhi(event, phi) { map[event] = phi; } storePhi("pizza", 0.069); storePhi("touched tree", -0.081); console.log("pizza" in map); // → true console.log(map["touched tree"]); // → -0.081 ~~~ [](http://eloquentjavascript.net/04_data.html#p_OlrE0O0+IT)A *map* is a way to go from values in one domain (in this case, event names) to corresponding values in another domain (in this case, *ϕ* coefficients). [](http://eloquentjavascript.net/04_data.html#p_Geo6ELctAH)There are a few potential problems with using objects like this, which we will discuss in [Chapter 6](http://eloquentjavascript.net/06_object.html#prototypes), but for the time being, we won’t worry about those. [](http://eloquentjavascript.net/04_data.html#p_esSmj3VTX0)What if we want to find all the events for which we have stored a coefficient? The properties don’t form a predictable series, like they would in an array, so we cannot use a normal `for` loop. JavaScript provides a loop construct specifically for going over the properties of an object. It looks a little like a normal `for` loop but distinguishes itself by the use of the word `in`. ~~~ for (var event in map) console.log("The correlation for '" + event + "' is " + map[event]); // → The correlation for 'pizza' is 0.069 // → The correlation for 'touched tree' is -0.081 ~~~ ## [](http://eloquentjavascript.net/04_data.html#h_Lg5n7mjqw/)The final analysis [](http://eloquentjavascript.net/04_data.html#p_o0qm2V9nGm)To find all the types of events that are present in the data set, we simply process each entry in turn and then loop over the events in that entry. We keep an object `phis` that has correlation coefficients for all the event types we have seen so far. Whenever we run across a type that isn’t in the `phis` object yet, we compute its correlation and add it to the object. ~~~ function gatherCorrelations(journal) { var phis = {}; for (var entry = 0; entry < journal.length; entry++) { var events = journal[entry].events; for (var i = 0; i < events.length; i++) { var event = events[i]; if (!(event in phis)) phis[event] = phi(tableFor(event, journal)); } } return phis; } var correlations = gatherCorrelations(JOURNAL); console.log(correlations.pizza); // → 0.068599434 ~~~ [](http://eloquentjavascript.net/04_data.html#p_XUj02Go7DR)Let’s see what came out. ~~~ for (var event in correlations) console.log(event + ": " + correlations[event]); // → carrot: 0.0140970969 // → exercise: 0.0685994341 // → weekend: 0.1371988681 // → bread: -0.0757554019 // → pudding: -0.0648203724 // and so on... ~~~ [](http://eloquentjavascript.net/04_data.html#p_TiI6dIjE18)Most correlations seem to lie close to zero. Eating carrots, bread, or pudding apparently does not trigger squirrel-lycanthropy. It *does* seem to occur somewhat more often on weekends, however. Let’s filter the results to show only correlations greater than 0.1 or less than -0.1. ~~~ for (var event in correlations) { var correlation = correlations[event]; if (correlation > 0.1 || correlation < -0.1) console.log(event + ": " + correlation); } // → weekend: 0.1371988681 // → brushed teeth: -0.3805211953 // → candy: 0.1296407447 // → work: -0.1371988681 // → spaghetti: 0.2425356250 // → reading: 0.1106828054 // → peanuts: 0.5902679812 ~~~ [](http://eloquentjavascript.net/04_data.html#p_V2ZEhvkhz3)A-ha! There are two factors whose correlation is clearly stronger than the others. Eating peanuts has a strong positive effect on the chance of turning into a squirrel, whereas brushing his teeth has a significant negative effect. [](http://eloquentjavascript.net/04_data.html#p_xpRHDuufcX)Interesting. Let’s try something. ~~~ for (var i = 0; i < JOURNAL.length; i++) { var entry = JOURNAL[i]; if (hasEvent("peanuts", entry) && !hasEvent("brushed teeth", entry)) entry.events.push("peanut teeth"); } console.log(phi(tableFor("peanut teeth", JOURNAL))); // → 1 ~~~ [](http://eloquentjavascript.net/04_data.html#p_WUlOiYWV3C)Well, that’s unmistakable! The phenomenon occurs precisely when Jacques eats peanuts and fails to brush his teeth. If only he weren’t such a slob about dental hygiene, he’d have never even noticed his affliction. [](http://eloquentjavascript.net/04_data.html#p_tPNATV9wwS)Knowing this, Jacques simply stops eating peanuts altogether and finds that this completely puts an end to his transformations. [](http://eloquentjavascript.net/04_data.html#p_DXAwHKoLIY)All is well with Jacques for a while. But a few years later, he loses his job and is eventually forced to take employment with a circus, where he performs as *The Incredible Squirrelman* by stuffing his mouth with peanut butter before every show. One day, fed up with this pitiful existence, Jacques fails to change back into his human form, hops through a crack in the circus tent, and vanishes into the forest. He is never seen again. ## [](http://eloquentjavascript.net/04_data.html#h_GFaxee4PuU)Further arrayology [](http://eloquentjavascript.net/04_data.html#p_U0+LZH9g+H)Before finishing up this chapter, I want to introduce you to a few more object-related concepts. We’ll start by introducing some generally useful array methods. [](http://eloquentjavascript.net/04_data.html#p_Wl9gXY97xi)We saw `push` and `pop`, which add and remove elements at the end of an array,[earlier](http://eloquentjavascript.net/04_data.html#array_methods) in this chapter. The corresponding methods for adding and removing things at the start of an array are called `unshift` and `shift`. ~~~ var todoList = []; function rememberTo(task) { todoList.push(task); } function whatIsNext() { return todoList.shift(); } function urgentlyRememberTo(task) { todoList.unshift(task); } ~~~ [](http://eloquentjavascript.net/04_data.html#p_msNR9KyjFO)The previous program manages lists of tasks. You add tasks to the end of the list by calling `rememberTo("eat")`, and when you’re ready to do something, you call `whatIsNext()` to get (and remove) the front item from the list. The`urgentlyRememberTo` function also adds a task but adds it to the front instead of the back of the list. [](http://eloquentjavascript.net/04_data.html#p_V9yB5Z4xWA)The `indexOf` method has a sibling called `lastIndexOf`, which starts searching for the given element at the end of the array instead of the front. ~~~ console.log([1, 2, 3, 2, 1].indexOf(2)); // → 1 console.log([1, 2, 3, 2, 1].lastIndexOf(2)); // → 3 ~~~ [](http://eloquentjavascript.net/04_data.html#p_hZ181L7UrW)Both `indexOf` and `lastIndexOf` take an optional second argument that indicates where to start searching from. [](http://eloquentjavascript.net/04_data.html#p_wxgx//Le/b)Another fundamental method is `slice`, which takes a start index and an end index and returns an array that has only the elements between those indices. The start index is inclusive, the end index exclusive. ~~~ console.log([0, 1, 2, 3, 4].slice(2, 4)); // → [2, 3] console.log([0, 1, 2, 3, 4].slice(2)); // → [2, 3, 4] ~~~ [](http://eloquentjavascript.net/04_data.html#p_Z01yQe26G8)When the end index is not given, `slice` will take all of the elements after the start index. Strings also have a `slice` method, which has a similar effect. [](http://eloquentjavascript.net/04_data.html#p_1mS9LYSSFD)The `concat` method can be used to glue arrays together, similar to what the `+`operator does for strings. The following example shows both `concat` and`slice` in action. It takes an array and an index, and it returns a new array that is a copy of the original array with the element at the given index removed. ~~~ function remove(array, index) { return array.slice(0, index) .concat(array.slice(index + 1)); } console.log(remove(["a", "b", "c", "d", "e"], 2)); // → ["a", "b", "d", "e"] ~~~ ## [](http://eloquentjavascript.net/04_data.html#h_mT4YQfwHp6)Strings and their properties [](http://eloquentjavascript.net/04_data.html#p_ZbMq0Cy4Fu)We can read properties like `length` and `toUpperCase` from string values. But if you try to add a new property, it doesn’t stick. ~~~ var myString = "Fido"; myString.myProperty = "value"; console.log(myString.myProperty); // → undefined ~~~ [](http://eloquentjavascript.net/04_data.html#p_B+oSPYAIbV)Values of type string, number, and Boolean are not objects, and though the language doesn’t complain if you try to set new properties on them, it doesn’t actually store those properties. The values are immutable and cannot be changed. [](http://eloquentjavascript.net/04_data.html#p_8L2ib2beYN)But these types do have some built-in properties. Every string value has a number of methods. The most useful ones are probably `slice` and `indexOf`, which resemble the array methods of the same name. ~~~ console.log("coconuts".slice(4, 7)); // → nut console.log("coconut".indexOf("u")); // → 5 ~~~ [](http://eloquentjavascript.net/04_data.html#p_RUd6q+Q4dc)One difference is that a string’s `indexOf` can take a string containing more than one character, whereas the corresponding array method looks only for a single element. ~~~ console.log("one two three".indexOf("ee")); // → 11 ~~~ [](http://eloquentjavascript.net/04_data.html#p_iSAQfJDhu8)The `trim` method removes whitespace (spaces, newlines, tabs, and similar characters) from the start and end of a string. ~~~ console.log(" okay \n ".trim()); // → okay ~~~ [](http://eloquentjavascript.net/04_data.html#p_J4kiFmHyRO)We have already seen the string type’s `length` property. Accessing the individual characters in a string can be done with the `charAt` method but also by simply reading numeric properties, like you’d do for an array. ~~~ var string = "abc"; console.log(string.length); // → 3 console.log(string.charAt(0)); // → a console.log(string[1]); // → b ~~~ ## [](http://eloquentjavascript.net/04_data.html#h_GstIcsgxyb)The arguments object [](http://eloquentjavascript.net/04_data.html#p_8jQc6BP3jE)Whenever a function is called, a special variable named `arguments` is added to the environment in which the function body runs. This variable refers to an object that holds all of the arguments passed to the function. Remember that in JavaScript you are allowed to pass more (or fewer) arguments to a function than the number of parameters the function itself declares. ~~~ function noArguments() {} noArguments(1, 2, 3); // This is okay function threeArguments(a, b, c) {} threeArguments(); // And so is this ~~~ [](http://eloquentjavascript.net/04_data.html#p_X05+xpRc+j)The `arguments` object has a `length` property that tells us the number of arguments that were really passed to the function. It also has a property for each argument, named 0, 1, 2, and so on. [](http://eloquentjavascript.net/04_data.html#p_r7f/a3/GFP)If that sounds a lot like an array to you, you’re right, it *is* a lot like an array. But this object, unfortunately, does not have any array methods (like `slice` or`indexOf`), so it is a little harder to use than a real array. ~~~ function argumentCounter() { console.log("You gave me", arguments.length, "arguments."); } argumentCounter("Straw man", "Tautology", "Ad hominem"); // → You gave me 3 arguments. ~~~ [](http://eloquentjavascript.net/04_data.html#p_MIxvg5Tzop)Some functions can take any number of arguments, like `console.log`. These typically loop over the values in their `arguments` object. They can be used to create very pleasant interfaces. For example, remember how we created the entries to Jacques’ journal. ~~~ addEntry(["work", "touched tree", "pizza", "running", "television"], false); ~~~ [](http://eloquentjavascript.net/04_data.html#p_2WHMCXaaIn)Since he is going to be calling this function a lot, we could create an alternative that is easier to call. ~~~ function addEntry(squirrel) { var entry = {events: [], squirrel: squirrel}; for (var i = 1; i < arguments.length; i++) entry.events.push(arguments[i]); journal.push(entry); } addEntry(true, "work", "touched tree", "pizza", "running", "television"); ~~~ [](http://eloquentjavascript.net/04_data.html#p_o3+Bq1M1pm)This version reads its first argument (`squirrel`) in the normal way and then goes over the rest of the arguments (the loop starts at index 1, skipping the first) to gather them into an array. ## [](http://eloquentjavascript.net/04_data.html#h_C51DnYk8WZ)The Math object [](http://eloquentjavascript.net/04_data.html#p_9S5JZybGFD)As we’ve seen, `Math` is a grab-bag of number-related utility functions, such as`Math.max` (maximum), `Math.min` (minimum), and `Math.sqrt` (square root). [](http://eloquentjavascript.net/04_data.html#p_YvGRywRVYj)The `Math` object is used simply as a container to group a bunch of related functionality. There is only one `Math` object, and it is almost never useful as a value. Rather, it provides a *namespace* so that all these functions and values do not have to be global variables. [](http://eloquentjavascript.net/04_data.html#p_fGEMziAXhp)Having too many global variables “pollutes” the namespace. The more names that have been taken, the more likely you are to accidentally overwrite the value of some variable. For example, it’s not unlikely that you’ll want to name something `max` in one of your programs. Since JavaScript’s built-in `max`function is tucked safely inside the `Math` object, we don’t have to worry about overwriting it. [](http://eloquentjavascript.net/04_data.html#p_tEjnm+nh21)Many languages will stop you, or at least warn you, when you are defining a variable with a name that is already taken. JavaScript does neither, so be careful. [](http://eloquentjavascript.net/04_data.html#p_zWXQRNgLI/)Back to the `Math` object. If you need to do trigonometry, `Math` can help. It contains `cos` (cosine), `sin` (sine), and `tan` (tangent), as well as their inverse functions, `acos`, `asin`, and `atan`, respectively. The number π (pi)—or at least the closest approximation that fits in a JavaScript number—is available as`Math.PI`. (There is an old programming tradition of writing the names of constant values in all caps.) ~~~ function randomPointOnCircle(radius) { var angle = Math.random() * 2 * Math.PI; return {x: radius * Math.cos(angle), y: radius * Math.sin(angle)}; } console.log(randomPointOnCircle(2)); // → {x: 0.3667, y: 1.966} ~~~ [](http://eloquentjavascript.net/04_data.html#p_4kTWFGWGMm)If sines and cosines are not something you are very familiar with, don’t worry. When they are used in this book, in [Chapter 13](http://eloquentjavascript.net/13_dom.html#sin_cos), I’ll explain them. [](http://eloquentjavascript.net/04_data.html#p_a6xMq73yCc)The previous example uses `Math.random`. This is a function that returns a new pseudorandom number between zero (inclusive) and one (exclusive) every time you call it. ~~~ console.log(Math.random()); // → 0.36993729369714856 console.log(Math.random()); // → 0.727367032552138 console.log(Math.random()); // → 0.40180766698904335 ~~~ [](http://eloquentjavascript.net/04_data.html#p_LqSZpx/sgf)Though computers are deterministic machines—they always react the same way if given the same input—it is possible to have them produce numbers that appear random. To do this, the machine keeps a number (or a bunch of numbers) in its internal state. Then, every time a random number is requested, it performs some complicated deterministic computations on this internal state and returns part of the result of those computations. The machine also uses the outcome to change its own internal state so that the next “random” number produced will be different. [](http://eloquentjavascript.net/04_data.html#p_WnBKL1c/CF)If we want a whole random number instead of a fractional one, we can use`Math.floor` (which rounds down to the nearest whole number) on the result of `Math.random`. ~~~ console.log(Math.floor(Math.random() * 10)); // → 2 ~~~ [](http://eloquentjavascript.net/04_data.html#p_52aDRkOsyH)Multiplying the random number by 10 gives us a number greater than or equal to zero, and below 10\. Since `Math.floor` rounds down, this expression will produce, with equal chance, any number from 0 through 9. [](http://eloquentjavascript.net/04_data.html#p_1pKvkjRw0T)There are also the functions `Math.ceil` (for “ceiling”, which rounds up to a whole number) and `Math.round` (to the nearest whole number). ## [](http://eloquentjavascript.net/04_data.html#h_lRBZxXmo93)The global object [](http://eloquentjavascript.net/04_data.html#p_+IF2SIC4YV)The global scope, the space in which global variables live, can also be approached as an object in JavaScript. Each global variable is present as a property of this object. In browsers, the global scope object is stored in the`window` variable. ~~~ var myVar = 10; console.log("myVar" in window); // → true console.log(window.myVar); // → 10 ~~~ ## [](http://eloquentjavascript.net/04_data.html#h_ErccPg/l98)Summary [](http://eloquentjavascript.net/04_data.html#p_78ZfHX5x1B)Objects and arrays (which are a specific kind of object) provide ways to group several values into a single value. Conceptually, this allows us to put a bunch of related things in a bag and run around with the bag, instead of trying to wrap our arms around all of the individual things and trying to hold on to them separately. [](http://eloquentjavascript.net/04_data.html#p_ayhyxvWlMH)Most values in JavaScript have properties, the exceptions being `null` and`undefined`. Properties are accessed using `value.propName` or`value["propName"]`. Objects tend to use names for their properties and store more or less a fixed set of them. Arrays, on the other hand, usually contain varying numbers of conceptually identical values and use numbers (starting from 0) as the names of their properties. [](http://eloquentjavascript.net/04_data.html#p_1lcitbawCQ)There *are* some named properties in arrays, such as `length` and a number of methods. Methods are functions that live in properties and (usually) act on the value they are a property of. [](http://eloquentjavascript.net/04_data.html#p_ZtRACiqRCK)Objects can also serve as maps, associating values with names. The `in` operator can be used to find out whether an object contains a property with a given name. The same keyword can also be used in a `for` loop (`for (var name in object)`) to loop over an object’s properties. ## [](http://eloquentjavascript.net/04_data.html#h_TcUD2vzyMe)Exercises ### [](http://eloquentjavascript.net/04_data.html#h_8ZspxiCEC/)The sum of a range [](http://eloquentjavascript.net/04_data.html#p_fpyyiv/hm1)The [introduction](http://eloquentjavascript.net/00_intro.html#intro) of this book alluded to the following as a nice way to compute the sum of a range of numbers: ~~~ console.log(sum(range(1, 10))); ~~~ [](http://eloquentjavascript.net/04_data.html#p_PkFb/61ecP)Write a `range` function that takes two arguments, `start` and `end`, and returns an array containing all the numbers from `start` up to (and including) `end`. [](http://eloquentjavascript.net/04_data.html#p_0GiJNcBSop)Next, write a `sum` function that takes an array of numbers and returns the sum of these numbers. Run the previous program and see whether it does indeed return 55. [](http://eloquentjavascript.net/04_data.html#p_T5lVUHvYnd)As a bonus assignment, modify your `range` function to take an optional third argument that indicates the “step” value used to build up the array. If no step is given, the array elements go up by increments of one, corresponding to the old behavior. The function call `range(1, 10, 2)` should return `[1, 3, 5, 7, 9]`. Make sure it also works with negative step values so that `range(5, 2, -1)` produces `[5, 4, 3, 2]`. ~~~ // Your code here. console.log(sum(range(1, 10))); // → 55 console.log(range(5, 2, -1)); // → [5, 4, 3, 2] ~~~ ### [](http://eloquentjavascript.net/04_data.html#h_6xTmjj4Rf5)Reversing an array [](http://eloquentjavascript.net/04_data.html#p_0ysB6LgssH)Arrays have a method `reverse`, which changes the array by inverting the order in which its elements appear. For this exercise, write two functions,`reverseArray` and `reverseArrayInPlace`. The first, `reverseArray`, takes an array as argument and produces a *new* array that has the same elements in the inverse order. The second, `reverseArrayInPlace`, does what the `reverse`method does: it modifies the array given as argument in order to reverse its elements. Neither may use the standard `reverse` method. [](http://eloquentjavascript.net/04_data.html#p_0WdqLyJAyQ)Thinking back to the notes about side effects and pure functions in the [previous chapter](http://eloquentjavascript.net/03_functions.html#pure), which variant do you expect to be useful in more situations? Which one is more efficient? ~~~ // Your code here. console.log(reverseArray(["A", "B", "C"])); // → ["C", "B", "A"]; var arrayValue = [1, 2, 3, 4, 5]; reverseArrayInPlace(arrayValue); console.log(arrayValue); // → [5, 4, 3, 2, 1] ~~~ ### [](http://eloquentjavascript.net/04_data.html#h_nSTX34CM1M)A list [](http://eloquentjavascript.net/04_data.html#p_7AnSuS26HF)Objects, as generic blobs of values, can be used to build all sorts of data structures. A common data structure is the *list* (not to be confused with the array). A list is a nested set of objects, with the first object holding a reference to the second, the second to the third, and so on. ~~~ var list = { value: 1, rest: { value: 2, rest: { value: 3, rest: null } } }; ~~~ [](http://eloquentjavascript.net/04_data.html#p_2un5u6U14Q)The resulting objects form a chain, like this:  [](http://eloquentjavascript.net/04_data.html#p_NaI0fhp38z)A nice thing about lists is that they can share parts of their structure. For example, if I create two new values `{value: 0, rest: list}` and `{value: -1, rest: list}` (with `list` referring to the variable defined earlier), they are both independent lists, but they share the structure that makes up their last three elements. In addition, the original list is also still a valid three-element list. [](http://eloquentjavascript.net/04_data.html#p_iPlgVCeZGh)Write a function `arrayToList` that builds up a data structure like the previous one when given `[1, 2, 3]` as argument, and write a `listToArray` function that produces an array from a list. Also write the helper functions `prepend`, which takes an element and a list and creates a new list that adds the element to the front of the input list, and `nth`, which takes a list and a number and returns the element at the given position in the list, or `undefined` when there is no such element. [](http://eloquentjavascript.net/04_data.html#p_IZMCvYT0l2)If you haven’t already, also write a recursive version of `nth`. ~~~ // Your code here. console.log(arrayToList([10, 20])); // → {value: 10, rest: {value: 20, rest: null}} console.log(listToArray(arrayToList([10, 20, 30]))); // → [10, 20, 30] console.log(prepend(10, prepend(20, null))); // → {value: 10, rest: {value: 20, rest: null}} console.log(nth(arrayToList([10, 20, 30]), 1)); // → 20 ~~~ ### [](http://eloquentjavascript.net/04_data.html#h_IJBU+aXOIC)Deep comparison [](http://eloquentjavascript.net/04_data.html#p_xTwbRlqHNJ)The `==` operator compares objects by identity. But sometimes, you would prefer to compare the values of their actual properties. [](http://eloquentjavascript.net/04_data.html#p_gndt0hmgga)Write a function, `deepEqual`, that takes two values and returns true only if they are the same value or are objects with the same properties whose values are also equal when compared with a recursive call to `deepEqual`. [](http://eloquentjavascript.net/04_data.html#p_kFIc5gkwlo)To find out whether to compare two things by identity (use the `===` operator for that) or by looking at their properties, you can use the `typeof` operator. If it produces `"object"` for both values, you should do a deep comparison. But you have to take one silly exception into account: by a historical accident,`typeof null` also produces `"object"`. ~~~ // Your code here. var obj = {here: {is: "an"}, object: 2}; console.log(deepEqual(obj, obj)); // → true console.log(deepEqual(obj, {here: 1, object: 2})); // → false console.log(deepEqual(obj, {here: {is: "an"}, object: 2})); // → true ~~~ Your test for whether you are dealing with a real object will look something like`typeof x == "object" && x != null`. Be careful to compare properties only when *both* arguments are objects. In all other cases you can just immediately return the result of applying `===`. Use a `for`/`in` loop to go over the properties. You need to test whether both objects have the same set of property names and whether those properties have identical values. The first test can be done by counting the properties in both objects and returning false if the numbers of properties are different. If they’re the same, then go over the properties of one object, and for each of them, verify that the other object also has the property. The values of the properties are compared by a recursive call to `deepEqual`. Returning the correct value from the function is best done by immediately returning false when a mismatch is noticed and returning true at the end of the function.