What does the declare keyword do? | Interview Question

Q: What does the declare keyword do?

**Target Audience:** Developers who have seen `declare` in a codebase or a `.d.ts` file and want to know exactly what it does and does not do. **Difficulty:** Medium **TypeScript version:** Every compiler message and output below was produced with TypeScript 5.4.5 (`--strict`, target ES2022). > **How to read this doc:** Each idea is explained in plain language first, then tagged with `📌 Interview term:` so you also learn the exact words an interviewer expects. All output was produced by actually running the code; the **Verified** section quotes it in full. `declare` is the building block of two bigger topics with their own pages: [declaration files (.d.ts)](/interview-question/what-are-declaration-files-d-ts) are made of ambient declarations, and [module augmentation](/interview-question/what-is-module-augmentation) uses `declare module` and `declare global`. This page is about the keyword itself. ## 1. Why This Even Matters — A Story First You are writing a play. Halfway through,

The problem

Question presented to candidate: "You see declare const __APP_VERSION__: string; at the top of a file, and declare name: string; inside a class. What does the declare keyword do in each case, what does it compile to, and what can go wrong?"

What a strong answer should cover:

declare makes an ambient declaration: it tells the checker a value, function, class, enum or namespace exists at run time, and emits no JavaScript for it
Typical uses: build-time constants (bundler "define" replacements), globals from a script tag, declare global / declare module blocks, and the contents of .d.ts files
Ambient declarations cannot have initializers or bodies (TS1039, TS1183), and the compiler cannot check that the thing really exists: a wrong declaration is a run-time ReferenceError
declare on a class field (TypeScript 3.7+) is type-only: no field is emitted, so with useDefineForClassFields (the default at target ES2022+) it does not wipe a value set by the base class, unlike name!: string (TS2612)
The common class use: narrowing an inherited property type (declare resident: Dog) without changing run-time behaviour

Code / implementation expected: Optional — a declare const for a build constant and a declare class field, with what they emit.

declare
ambient

Try it yourself

Sketch your approach before you read the solution. That is what the interview tests.

Stuck? Get a hint.

A short nudge toward the approach. It will not give the answer away.

Solution

Target Audience: Developers who have seen declare in a codebase or a .d.ts file and want to know exactly what it does and does not do. Difficulty: Medium TypeScript version: Every compiler message and output below was produced with TypeScript 5.4.5 (--strict, target ES2022).

How to read this doc: Each idea is explained in plain language first, then tagged with 📌 Interview term: so you also learn the exact words an interviewer expects. All output was produced by actually running the code; the Verified section quotes it in full.

declare is the building block of two bigger topics with their own pages: declaration files (.d.ts) are made of ambient declarations, and module augmentation uses declare module and declare global. This page is about the ke

The solution is hidden so you can try first

10 min read · 9 sections

Run the code

Edit the code and run it here. Each console line with an expected value becomes a test.

TypeScriptAmbient declarations: types without emitted code

Practice

TypeScriptdeclare on class fields vs re-declaring with !

Practice

Discussion

Other approaches, follow-ups and how it went in real interviews.

Sign in to join the discussion.

No comments yet. Share how you would answer it.

The solution is hidden so you can try first

Keep your momentum going.