An interface in TypeScript defines the structure of an object — what properties it should have and what their types should be.
Think of it like a blueprint for objects.
✅ Basic Syntax
interface User {
name: string;
age: number;
isAdmin: boolean;
}You can then use this interface as a type:
const user: User = {
name: "Tisha",
age: 21,
isAdmin: true
};🧠 Optional Properties
Use ? to mark a property as optional:
interface User {
name: string;
age?: number; // optional
}🔐 Readonly Properties
Use readonly to make a property immutable:
interface Config {
readonly version: string;
debug: boolean;
}
const settings: Config = {
version: "1.0",
debug: true
};
settings.version = "2.0"; // ❌ Error🛠 Methods in Interfaces
interface Person {
name: string;
greet(msg: string): string;
}
const person: Person = {
name: "Alice",
greet: (msg) => `Hello ${msg}`
};
console.log(person.name) //Alice
console.log(person.greet("Codeveda")) //Hello Codeveda🔁 Extending Interfaces (Inheritance)
Interfaces can extend other interfaces:
interface Animal {
name: string;
}
interface Dog extends Animal {
breed: string;
}
const pet: Dog = {
name: "Tommy",
breed: "Labrador"
};
console.log(pet.name) //Tommy
console.log(pet.breed) //Labrador✨ Interface vs Type (Quick Recap)
Feature |
|
|
|---|---|---|
Object structure | ✅ | ✅ |
Unions/Intersections | ❌ | ✅ |
Can be extended | ✅ ( | ✅ ( |
Declaration merging | ✅ | ❌ |
Primitives, arrays, etc. | ❌ | ✅ |
🔥 Combined Example
<div class="infographic-ts" id="infographic-ts">
<style>
.infographic-ts {
--body-font: system-ui, -apple-system, sans-serif;
--mono-font: ui-monospace, SFMono-Regular, Consolas, "Courier New", monospace;
--ed-bg: #1e1e1e;
--ed-bar: #2a2a2a;
--ed-out: #d4d4d4;
--ed-muted: #8a8a8a;
--ed-ok: #4ec9b0;
--ed-err: #f14c4c;
--run-bg: #2e7d46;
--run-bg-hover: #35924f;
--tok-kw: #c586c0;
--tok-type: #4ec9b0;
--tok-str: #ce9178;
--tok-cmt: #808080;
--tok-var: #ffffff;
max-width: 680px;
margin: 0 auto;
box-sizing: border-box;
background: transparent;
font-family: var(--body-font);
}
.infographic-ts * { box-sizing: border-box; }
.ts-header { font-family: 'Georgia', 'Fraunces', serif; font-weight: 700;
font-size: 1.9rem; letter-spacing: 0.01em; color: inherit; text-align: center;
margin: 0 0 1.4rem; }
.code-window { background: var(--ed-bg); border: 1px solid #2f2f2f; border-radius: 8px;
overflow: hidden; margin-bottom: 1rem; }
.code-topbar { display: flex; align-items: center; justify-content: space-between;
padding: 0.5rem 0.75rem; background: var(--ed-bar); }
.code-dots { display: flex; gap: 6px; }
.code-dot { width: 9px; height: 9px; border-radius: 50%; }
.code-dot.r { background: #ff5f57; }
.code-dot.y { background: #febc2e; }
.code-dot.g { background: #28c840; }
.code-filename { font-family: var(--mono-font); font-size: 0.74rem; color: var(--ed-muted); }
.run-btn { display: inline-flex; align-items: center; gap: 0.35rem; background: var(--run-bg);
color: #fff; border: none; border-radius: 4px; padding: 0.32rem 0.7rem; font-size: 0.74rem;
font-family: var(--body-font); font-weight: 500; cursor: pointer; }
.run-btn:hover { background: var(--run-bg-hover); }
.run-btn svg { width: 10px; height: 10px; }
.code-body { padding: 0.85rem 1.1rem; font-family: var(--mono-font); font-size: 0.8rem;
line-height: 1.65; color: var(--ed-out); white-space: pre; overflow-x: auto; }
.tok-kw { color: var(--tok-kw); }
.tok-type { color: var(--tok-type); }
.tok-str { color: var(--tok-str); }
.tok-punc { color: var(--tok-var); }
.tok-cmt { color: var(--tok-cmt); }
.tok-var { color: var(--tok-var); }
.console { padding: 0 1.1rem; max-height: 0; overflow: hidden; font-family: var(--mono-font);
font-size: 0.78rem; line-height: 1.65; transition: max-height 0.35s ease, padding 0.35s ease; }
.console.show { max-height: 260px; padding: 0 1.1rem 0.85rem; }
.console-line { color: var(--ed-out); }
.console-line.ok { color: var(--ed-ok); }
.console-line.err { color: var(--ed-err); }
.note-line { font-family: var(--body-font); font-size: 0.8rem; color: var(--ed-muted);
padding: 0 0.2rem; margin: 0; }
.runtime-highlight { background: #2a2a2c; border-left: 3px solid var(--ed-ok);
border-radius: 6px; margin: 0.6rem 0.35rem 0.7rem; padding: 0.85rem 1.1rem;
box-shadow: 0 2px 10px rgba(0,0,0,0.35); }
.highlight-label { font-family: var(--body-font); font-size: 0.74rem; color: var(--ed-ok);
font-weight: 500; margin: 0.9rem 0 0.15rem; padding: 0 1.1rem; }
</style>
<div class="code-window">
<div class="code-topbar">
<div class="code-dots"><span class="code-dot r"></span><span class="code-dot y"></span><span class="code-dot g"></span></div>
<span class="code-filename">pet.ts</span>
<button class="run-btn" id="runBtn" type="button">
<svg viewBox="0 0 24 24" fill="currentColor"><polygon points="6 3 20 12 6 21 6 3"/></svg>
run
</button>
</div>
<div class="code-body"><span class="tok-kw">interface</span> <span class="tok-type">Animal</span> <span class="tok-punc">{</span>
<span class="tok-var">name</span><span class="tok-punc">:</span> <span class="tok-type">string</span><span class="tok-punc">;</span>
<span class="tok-var">age</span><span class="tok-punc">?:</span> <span class="tok-type">number</span><span class="tok-punc">;</span> <span class="tok-cmt">// optional</span>
<span class="tok-kw">readonly</span> <span class="tok-var">species</span><span class="tok-punc">:</span> <span class="tok-type">string</span><span class="tok-punc">;</span> <span class="tok-cmt">// readonly</span>
<span class="tok-var">makeSound</span><span class="tok-punc">():</span> <span class="tok-type">string</span><span class="tok-punc">;</span> <span class="tok-cmt">// method</span>
<span class="tok-punc">}</span>
<span class="tok-kw">interface</span> <span class="tok-type">Dog</span> <span class="tok-kw">extends</span> <span class="tok-type">Animal</span> <span class="tok-punc">{</span> <span class="tok-cmt">// extends</span>
<span class="tok-var">breed</span><span class="tok-punc">:</span> <span class="tok-type">string</span><span class="tok-punc">;</span>
<span class="tok-punc">}</span></div>
<p class="highlight-label">↓ using it</p>
<div class="code-body runtime-highlight"><span class="tok-kw">const</span> <span class="tok-var">pet</span><span class="tok-punc">:</span> <span class="tok-type">Dog</span> <span class="tok-punc">=</span> <span class="tok-punc">{</span>
<span class="tok-var">name</span><span class="tok-punc">:</span> <span class="tok-str">"Tommy"</span><span class="tok-punc">,</span>
<span class="tok-var">species</span><span class="tok-punc">:</span> <span class="tok-str">"Canine"</span><span class="tok-punc">,</span>
<span class="tok-var">breed</span><span class="tok-punc">:</span> <span class="tok-str">"Labrador"</span><span class="tok-punc">,</span>
<span class="tok-var">makeSound</span><span class="tok-punc">:</span> <span class="tok-punc">()</span> <span class="tok-punc">=></span> <span class="tok-str">"Woof!"</span>
<span class="tok-punc">};</span>
<span class="tok-var">console</span><span class="tok-punc">.</span><span class="tok-var">log</span><span class="tok-punc">(</span><span class="tok-var">pet</span><span class="tok-punc">.</span><span class="tok-var">name</span><span class="tok-punc">,</span> <span class="tok-var">pet</span><span class="tok-punc">.</span><span class="tok-var">breed</span><span class="tok-punc">,</span> <span class="tok-var">pet</span><span class="tok-punc">.</span><span class="tok-var">makeSound</span><span class="tok-punc">());</span>
<span class="tok-var">console</span><span class="tok-punc">.</span><span class="tok-var">log</span><span class="tok-punc">(</span><span class="tok-var">pet</span><span class="tok-punc">.</span><span class="tok-var">age</span><span class="tok-punc">);</span> <span class="tok-cmt">// never set</span>
<span class="tok-var">pet</span><span class="tok-punc">.</span><span class="tok-var">species</span> <span class="tok-punc">=</span> <span class="tok-str">"Feline"</span><span class="tok-punc">;</span> <span class="tok-cmt">// readonly</span></div>
<div class="console" id="runConsole"></div>
</div>
<p class="note-line">Dog inherits name, age and species from Animal, then adds breed — one interface built from five features.</p>
<script>
(function () {
var wrapper = document.currentScript.closest('.infographic-ts')
|| document.querySelector('.infographic-ts');
var root = wrapper;
function line(consoleEl, cls, text) {
var el = document.createElement('div');
el.className = 'console-line ' + (cls || '');
el.textContent = text;
consoleEl.appendChild(el);
}
var btn = root.querySelector('#runBtn');
var c = root.querySelector('#runConsole');
btn.addEventListener('click', function () {
c.innerHTML = '';
c.classList.add('show');
line(c, 'ok', 'Tommy Labrador Woof!');
line(c, 'ok', 'undefined');
line(c, 'err', "pet.species = \"Feline\" \u2192 Error: Cannot assign to 'species' because it is a read-only property.");
setTimeout(function () {
c.scrollIntoView({ behavior: 'smooth', block: 'end' });
}, 50);
});
})();
</script>
</div>📌 Summary
Concept | Syntax |
|---|---|
Basic interface |
|
Optional |
|
Readonly |
|
Method |
|
Extend |
|
✅ Interfaces are clean, extendable, and perfect for defining object models.
They also integrate well with OOP patterns, React props, and API responses.