Java With Us

The <code>instanceof</code> Operator in Java

Updated on 2026-04-21 Reviewed by the Java With Us editorial team

instanceof tests whether a reference points to an object of a given type (or a subtype). It returns true for null? No — null instanceof X is always false. Since Java 16, instanceof also declares a variable of the matched type.

Classic syntax

Object o = "hello";
if (o instanceof String) {
    String s = (String) o;        // cast needed
    System.out.println(s.length());
}

Pattern matching (Java 16+)

if (o instanceof String s) {       // declares `s`, bound only in true branch
    System.out.println(s.length());
}

if (o instanceof String s && s.length() > 0) {
    ...                            // `s` usable here
}

The variable is only in scope where the test is known to be true. It's implicitly final.

Pattern matching for switch (Java 21+)

String describe(Object o) {
    return switch (o) {
        case Integer i when i > 0 -> "positive int";
        case Integer i            -> "non-positive int";
        case String s             -> "string of " + s.length();
        case null                 -> "null";
        default                   -> "unknown";
    };
}

instanceof vs getClass()

Object o = new Dog();
o instanceof Animal;       // true — subclass relationship
o.getClass() == Animal.class;  // false — exact class only

Use instanceof for "is-a" checks (including subclasses). Use getClass() only if you need exact-class equality, typically in a rigorous equals implementation.

Generics and instanceof

// ❌ can't test a generic type at runtime (type erasure)
if (x instanceof List<String>)     // compile error

// ✅ test the raw shape
if (x instanceof List<?> list)     // OK — use wildcards

Common mistakes

  • Cascades of if / else if with instanceof — often a sign that polymorphism would be cleaner. But when you truly need to handle many external types (events, messages), pattern-matching switch is the right tool.
  • Not checking before cast — (String) o throws ClassCastException at runtime.
  • Mixing instanceof with == on primitives — instanceof only works on references.

Related

Pillar: Java keywords. See also instanceof operator, ClassCastException.

Related articles