Saint Vandora
JavaScript Common Mistakes

Photo by Andrew Neel on Unsplash

JavaScript Common Mistakes

FOLASAYO SAMUEL OLAYEMI's photo
FOLASAYO SAMUEL OLAYEMI
·

7 min read

Table of contents

Accidentally Using the Assignment Operator

JavaScript programs may generate unexpected results if a programmer accidentally uses an assignment operator (=), instead of a comparison operator (==) in an if statement.

This if statement returns false (as expected) because x is not equal to 10.

Code Sample:

<!DOCTYPE html>
<html>
<body>

<p id="demo"></p>

<script>
var x = 0;
document.getElementById("demo").innerHTML = Boolean(x == 10);
</script>

</body>
</html>

This if statement returns true (maybe not as expected), because 10 is true.

Code Sample:

<!DOCTYPE html>
<html>
<body>

<p id="demo"></p>

<script>
var x = 0;
document.getElementById("demo").innerHTML = Boolean(x = 10);
</script>

</body>
</html>

This if statement returns false (maybe not as expected), because 0 is false.

Code Sample:

<!DOCTYPE html>
<html>
<body>

<p id="demo"></p>

<script>
var x = 0;
document.getElementById("demo").innerHTML = Boolean(x = 0);
</script>

</body>
</html>

Note: An assignment always returns the value of the assignment.

Expecting Loose Comparison

In regular comparison, data type does not matter. This if statement returns true.

Code Sample:

<!DOCTYPE html>
<html>
<body>

<p id="demo"></p>

<script>
var x = 10;
var y = "10";
document.getElementById("demo").innerHTML = Boolean(x == y);
</script>

</body>
</html>

In strict comparison, data type does matter. This if statement returns false.

Code Sample:

<!DOCTYPE html>
<html>
<body>

<p id="demo"></p>

<script>
var x = 10;
var y = "10";
document.getElementById("demo").innerHTML = Boolean(x === y);
</script>

</body>
</html>

It is a common mistake to forget that switch statements use strict comparison.

Code Sample: This case switch will display an alert:

<!DOCTYPE html>
<html>
<body>

<p id="demo"></p>

<script>
var x = 10;
switch(x) {
  case 10: alert("Hello");
}
</script>

</body>
</html>

This case switch will not display an alert:

<!DOCTYPE html>
<html>
<body>

<p id="demo"></p>

<script>
var x = 10;
switch(x) {
  case "10": alert("Hello");
}
</script>

</body>
</html>

Confusing Addition & Concatenation

Addition is about adding numbers. Concatenation is about adding strings. In JavaScript both operations use the same + operator.

Because of this, adding a number as a number will produce a different result from adding a number as a string.

Code Sample:

var x = 10 + 5;          // the result in x is 15
var x = 10 + "5";        // the result in x is "105"

When adding two variables, it can be difficult to anticipate the result.

Code Sample:

var x = 10;
var y = 5;
var z = x + y;           // the result in z is 15

var x = 10;
var y = "5";
var z = x + y;           // the result in z is "105"

Misunderstanding Floats

All numbers in JavaScript are stored as 64-bits Floating point numbers (Floats). All programming languages, including JavaScript, have difficulties with precise floating point values.

Code Sample:

var x = 0.1;
var y = 0.2;
var z = x + y            // the result in z will not be 0.3

To solve the problem above, it helps to multiply and divide.

Code Sample:

var z = (x * 10 + y * 10) / 10;       // z will be 0.3

Breaking a JavaScript String

JavaScript will allow you to break a statement into two lines.

Code Sample:

var x =
"Hello World!";

But, breaking a statement in the middle of a string will not work.

Code Sample:

var x = "Hello
World!";

You must use a "backslash" if you must break a statement in a string.

Code Sample:

var x = "Hello \
World!";

Misplacing Semicolon

Because of a misplaced semicolon, this code block will execute regardless of the value of x:

<!DOCTYPE html>
<html>
<body>

<p id="demo"></p>

<script>
var x = 5;
if (x == 19);
{
document.getElementById("demo").innerHTML = "Hello";
}
</script>

</body>
</html>

Breaking a Return Statement

It is a default JavaScript behavior to close a statement automatically at the end of a line. Because of this, these two examples will return the same result:

<!DOCTYPE html>
<html>
<body>

<p id="demo"></p>

<script>
document.getElementById("demo").innerHTML = myFunction(55);
function myFunction(a) {
  var power = 10
  return a * power
}
</script>

</body>
</html>

JavaScript will also allow you to break a statement into two lines.

Code Sample:

function myFunction(a) {
  var
  power = 10; 
  return a * power;
}

But, what will happen if you break the return statement in two lines like this:

function myFunction(a) {
  var
  power = 10; 
  return
  a * power;
}

The function will return undefined! Why? Because JavaScript thought you meant:

function myFunction(a) {
  var
  power = 10; 
  return;
  a * power;
}

Explanation

If a statement is incomplete like:

var

JavaScript will try to complete the statement by reading the next line:

power = 10;

But since this statement is complete:

return

JavaScript will automatically close it like this:

return;

This happens because closing (ending) statements with semicolon is optional in JavaScript. JavaScript will close the return statement at the end of the line, because it is a complete statement.

Note: Never break a return statement.

Accessing Arrays with Named Indexes

Many programming languages support arrays with named indexes. Arrays with named indexes are called associative arrays (or hashes). JavaScript does not support arrays with named indexes.

In JavaScript, arrays use numbered indexes:

Code Sample:

<!DOCTYPE html>
<html>
<body>

<h2>JavaScript Arrays</h2>

<p id="demo"></p>

<script>
var person = [];
person[0] = "John";
person[1] = "Doe";
person[2] = 46; 
document.getElementById("demo").innerHTML =
person[0] + " " + person.length;
</script>

</body>
</html>

In JavaScript, objects use named indexes. If you use a named index, when accessing an array, JavaScript will redefine the array to a standard object.

After the automatic redefinition, array methods and properties will produce undefined or incorrect results.

Code Sample:

<!DOCTYPE html>
<html>
<body>

<h2>JavaScript Arrays</h2>

<p>If you use a named index when accessing an array, JavaScript will redefine the array to a standard object, and some array methods and properties will produce undefined or incorrect results.</p>

<p id="demo"></p>

<script>
var person = [];
person["firstName"] = "John";
person["lastName"] = "Doe";
person["age"] = 46; 
document.getElementById("demo").innerHTML =
person[0] + " " + person.length;
</script>

</body>
</html>

Ending Definitions with a Comma

Trailing commas in object and array definition are legal in ECMAScript 5.

Object Example:

person = {firstName:"John", lastName:"Doe", age:46,}

Array Example:

points = [40, 100, 1, 5, 25, 10,];

Note: Internet Explorer 8 will crash. JSON does not allow trailing commas.

JSON:

person = {"firstName":"John", "lastName":"Doe", "age":46}

JSON:

points = [40, 100, 1, 5, 25, 10];

Undefined is Not Null

JavaScript objects, variables, properties, and methods can be undefined. In addition, empty JavaScript objects can have the value null. This can make it a little bit difficult to test if an object is empty.

You can test if an object exists by testing if the type is undefined.

Code Sample:

<!DOCTYPE html>
<html>
<body>

<h2>JavaScript</h2>

<p>To test if an object does not exist, test if the type is undefined:</p>

<p id="demo"></p>

<script>
document.getElementById("demo").innerHTML = typeof myObj === "undefined";
</script>

</body>
</html>

But you cannot test if an object is null, because this will throw an error if the object is undefined.

if (myObj === null)

To solve this problem, you must test if an object is not null, and not undefined.

But this can still throw an error.

Code Sample

if (myObj !== null && typeof myObj !== "undefined")

Because of this, you must test for not undefined before you can test for not null.

Code Sample:

if (typeof myObj !== "undefined" && myObj !== null)

Expecting Block Level Scope

JavaScript does not create a new scope for each code block. It is true in many programming languages, but not true in JavaScript.

This code will display the value of i (10), even OUTSIDE the for loop block:

<!DOCTYPE html>
<html>
<body>

<h2>JavaScript</h2>

<p>JavaScript does not create a new scope for each code block.</p>

<p>This code will display the value of i (10), even OUTSIDE the for loop block:</p>

<p id="demo"></p>

<script>
for (var i = 0; i < 10; i++) {
  // some code
}
document.getElementById("demo").innerHTML = i;
</script>

</body>
</html>

Thanks for reading...

Happy Coding!

Did you find this article valuable?

Support Saint Vandora by becoming a sponsor. Any amount is appreciated!

JavaScriptGeneral ProgrammingWeb DevelopmentReactPython