JavaScript Guide
Beginner9 mins readJS String Methods Reference

String includes()

Complete String includes() reference with syntax, parameters, return value, mutation behavior, examples, output, mistakes, best practices, interview questions, practice tasks, and quiz.

Overview & Purpose

String includes() is a JavaScript reference topic. This page focuses on what it does, why you would use it, what it returns, whether it changes the original value, and how it appears in real code.

Topic Definition

includes() is the exact operation explained on this reference page. In JavaScript, the important details are the receiver value, accepted arguments, callback behavior if any, returned value, and whether the original data changes. String includes() should be learned as a practical API: first read the syntax, then run the basic example, then check the output, then confirm mutation behavior. This prevents the most common method-reference mistakes, especially when arrays, strings, objects, dates, Math utilities, promises, or browser APIs look similar but return different results.

Why It Matters

Use includes() when its return value and side-effect behavior match your task. The method gives your code a standard vocabulary, reduces custom loops or manual parsing, and makes code reviews easier because other JavaScript developers already know the expected behavior. It is especially useful when you need predictable data transformation, lookup, formatting, async handling, or value calculation.

Syntax Guide

javascript
string.includes(searchString, position)
Reference API Specifications
Parameters:
  • searchString: text to find
  • position: optional index where the search starts
  • Mutation behavior: No. includes() only reads the string.
  • Similar method guidance: Use indexOf() when you need the exact position instead of a boolean.
Return Value:

Returns true if the search text exists, otherwise false.

Syntax Explanation: includes() should be understood by reading its inputs, return value, and side effects. The most important question is whether it returns a new value or changes the original value.

Runnable Code Examples

Example 1: includes() basic example

A focused example showing the core behavior.

javascript
const message = "Learn JavaScript arrays";
console.log(message.includes("JavaScript"));
console.log(message.includes("Python"));
expected console output
true false

Breakdown: This is the smallest useful example for checking the method behavior.

Example 2: includes() with array of objects

A practical data example similar to UI/API code.

javascript
const users = [
  { name: "Asha", active: true },
  { name: "Ravi", active: false }
];
const names = users.map((user) => user.name);
console.log(names);
expected console output
["Asha", "Ravi"]

Breakdown: Arrays of objects are common when rendering users, products, orders, or API responses.

Example 3: includes() in real-world code

A short helper that formats data for display.

javascript
function formatResult(label, value) {
  return label + ": " + value;
}
console.log(formatResult("includes()", "ready"));
expected console output
includes(): ready

Breakdown: Real apps often wrap method output in small helper functions before rendering it.

Real-world Use Cases

  • 1Using includes() while transforming API response data.
  • 2Applying includes() in search, filter, sort, and display logic.
  • 3Using includes() inside form validation or input cleanup.
  • 4Combining includes() with React or Next.js rendering code.
  • 5Explaining includes() in output-based interview questions.

Avoid Common Mistakes

Mistake 1

Forgetting this rule: No. includes() only reads the string.

Mistake 2

Ignoring the return value of includes().

Mistake 3

Passing the wrong callback return type.

Mistake 4

Not testing empty input before using production data.

Mistake 5

Confusing this method with a similar method from the same family.

Pro Tips & Practices

Practice 1

Read includes() from left to right: receiver, arguments, return value.

Practice 2

Store returned values in clearly named constants.

Practice 3

Avoid mutating data unless the method is intentionally mutating.

Practice 4

Write one small example before using the method in a larger feature.

Practice 5

Add tests for empty input and single-item input.

Pro Tip 1

Memorize whether includes() mutates data; it prevents many bugs.

Pro Tip 2

Use console.table when the method returns arrays of objects.

Pro Tip 3

Prefer chaining only when each step remains readable.

Pro Tip 4

Split complex callbacks into named functions.

Pro Tip 5

Compare this method with its closest alternative before choosing it.

Coding Exercises

1

Exercise Challenge

Write a minimal example that demonstrates String includes().

2

Exercise Challenge

Change the input in the String includes() example and predict the output before running it.

3

Exercise Challenge

Wrap the String includes() example inside a reusable function.

4

Exercise Challenge

Handle an empty value when using String includes().

5

Exercise Challenge

Explain String includes() in one comment above your code.

6

Exercise Challenge

Combine String includes() with a conditional branch.

7

Exercise Challenge

Create a real-world variable name for String includes().

8

Exercise Challenge

Add error-safe logging around String includes().

9

Exercise Challenge

Write one best-practice rule for String includes().

10

Exercise Challenge

Refactor the String includes() example to use const where reassignment is not needed.

Practice Tasks Checklist

1Write the syntax of includes() from memory.
2Create one basic includes() example and log the output.
3Use includes() with an array of objects or realistic string data.
4Check whether includes() mutates the original value.
5Compare includes() with a similar method in two sentences.
6Handle empty input before calling includes().
7Write a helper function that wraps includes().
8Create one output-based interview question for includes().
9Use includes() in a UI-like data formatting task.
10Add one best-practice comment above your includes() example.

String includes() Quiz Challenges

1

Quiz Challenge

What is the main purpose of String includes()?

2

Quiz Challenge

Which question should you ask first when using String includes()?

3

Quiz Challenge

What should a good String includes() example include?

4

Quiz Challenge

Why should you test edge cases for String includes()?

5

Quiz Challenge

Where is String includes() most likely to appear?

6

Quiz Challenge

What is a strong interview answer for String includes()?

7

Quiz Challenge

Which debugging step is most useful for String includes()?

8

Quiz Challenge

What makes String includes() content high quality for learning?

9

Quiz Challenge

What should you compare when choosing String includes() over a related topic?

10

Quiz Challenge

What is the best way to master String includes()?

Technical Interview Q&As

1String includes() interview question 1: define the topic in simple language.

Model Answer:

String includes() should be answered with a clear definition, topic-specific syntax, one small example, the expected output, and a practical use case. For this question, focus on the meaning and purpose of the concept.
2String includes() interview question 2: show the smallest useful example.

Model Answer:

String includes() should be answered with a clear definition, topic-specific syntax, one small example, the expected output, and a practical use case. For this question, focus on the minimum code needed to demonstrate it.
3String includes() interview question 3: predict the output of a sample.

Model Answer:

String includes() should be answered with a clear definition, topic-specific syntax, one small example, the expected output, and a practical use case. For this question, focus on why the output appears in that order.
4String includes() interview question 4: explain the most common mistake.

Model Answer:

String includes() should be answered with a clear definition, topic-specific syntax, one small example, the expected output, and a practical use case. For this question, focus on the mistake that usually causes bugs.
5String includes() interview question 5: describe a real project use case.

Model Answer:

String includes() should be answered with a clear definition, topic-specific syntax, one small example, the expected output, and a practical use case. For this question, focus on where it appears in production JavaScript.
6String includes() interview question 6: compare it with a related JavaScript topic.

Model Answer:

String includes() should be answered with a clear definition, topic-specific syntax, one small example, the expected output, and a practical use case. For this question, focus on how it differs from a nearby concept.
7String includes() interview question 7: explain how to debug it.

Model Answer:

String includes() should be answered with a clear definition, topic-specific syntax, one small example, the expected output, and a practical use case. For this question, focus on which console or breakpoint checks reveal the issue.
8String includes() interview question 8: mention edge cases.

Model Answer:

String includes() should be answered with a clear definition, topic-specific syntax, one small example, the expected output, and a practical use case. For this question, focus on empty input, wrong type, and boundary behavior.
9String includes() interview question 9: state best practices.

Model Answer:

String includes() should be answered with a clear definition, topic-specific syntax, one small example, the expected output, and a practical use case. For this question, focus on readability, safety, and maintainability.
10String includes() interview question 10: explain when not to use it.

Model Answer:

String includes() should be answered with a clear definition, topic-specific syntax, one small example, the expected output, and a practical use case. For this question, focus on situations where another approach is clearer.

Related Lessons

JS Array MethodsJS String MethodsJS ObjectsJS Promises

Frequently Asked Questions

Previous Lesson

String split()

Next Lesson

String startsWith()