A Generic Class allows you to create a class that works with any type(s), determined when you create an instance of the class.
✅ Basic Syntax
class Box<T> {
content: T;
constructor(value: T) {
this.content = value;
}
getContent(): T {
return this.content;
}
}
const numberBox = new Box<number>(123);
const stringBox = new Box<string>("TypeScript");Here:
Tis a type placeholder.When creating
new Box<number>(),Tbecomesnumber.
🧮 Multiple Type Parameters
class Pair<K, V> {
key: K;
value: V;
constructor(key: K, value: V) {
this.key = key;
this.value = value;
}
}
const pair = new Pair<string, number>("age", 25);🛠️ Class with Methods Using Generics
class Collection<T> {
private items: T[] = [];
add(item: T): void {
this.items.push(item);
}
getAll(): T[] {
return this.items;
}
}
const stringCollection = new Collection<string>();
stringCollection.add("apple");
stringCollection.add("banana");
const allStrings = stringCollection.getAll(); // string[]⛓️ Constraining Generic Types
Use extends to restrict the kinds of types allowed for T.
interface HasId {
id: number;
}
class EntityManager<T extends HasId> {
private entities: T[] = [];
add(entity: T) {
this.entities.push(entity);
}
getById(id: number): T | undefined {
return this.entities.find(e => e.id === id);
}
}
const manager = new EntityManager<{ id: number; name: string }>();
manager.add({ id: 1, name: "Tisha" });📦 Default Generic Type
class ApiResponse<T = any> {
constructor(public data: T, public success: boolean) {}
}
const response = new ApiResponse("All good!", true); // T = string
const defaultResponse = new ApiResponse(123, true); // T = number<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;
--run-bg: #2e7d46;
--run-bg-hover: #35924f;
--tok-kw: #c586c0;
--tok-type: #4ec9b0;
--tok-str: #ce9178;
--tok-num: #b5cea8;
--tok-punc: #d4d4d4;
--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; }
.tabs { display: flex; justify-content: center; gap: 4px; margin-bottom: 1.1rem; flex-wrap: wrap; }
.tab-btn { font-family: var(--body-font); font-size: 0.82rem; font-weight: 500;
background: #ffffff; color: #2563eb; border: 1px solid #2563eb; padding: 0.65rem 1rem;
cursor: pointer; border-radius: 8px; }
.tab-btn.active { background: #2563eb; color: #ffffff; }
.tab-btn:hover:not(.active) { background: #eef3ff; }
.tab-panel { display: none; background: var(--ed-bg); border-radius: 8px;
padding: 1.1rem; }
.tab-panel.active { display: block; }
.code-window { background: var(--ed-bg); border: 1px solid #2f2f2f; border-radius: 8px;
overflow: hidden; margin-bottom: 1rem; }
.code-window:last-child { margin-bottom: 0; }
.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-num { color: var(--tok-num); }
.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); }
.note-line { font-family: var(--body-font); font-size: 0.8rem; color: var(--ed-muted);
padding: 0 0.2rem; margin: 0; }
</style>
<h2 class="ts-header">Generic classes</h2>
<div class="tabs">
<button class="tab-btn active" data-tab="t1" type="button">Basic</button>
<button class="tab-btn" data-tab="t2" type="button">Multiple params</button>
<button class="tab-btn" data-tab="t3" type="button">Methods</button>
<button class="tab-btn" data-tab="t4" type="button">Constraints</button>
<button class="tab-btn" data-tab="t5" type="button">Default type</button>
</div>
<div class="tab-panel active" id="t1">
<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">box.ts</span>
<button class="run-btn" id="boxBtn" 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">class</span> <span class="tok-type">Box</span><span class="tok-punc"><</span><span class="tok-type">T</span><span class="tok-punc">></span> <span class="tok-punc">{</span>
<span class="tok-var">content</span><span class="tok-punc">:</span> <span class="tok-type">T</span><span class="tok-punc">;</span>
<span class="tok-var">constructor</span><span class="tok-punc">(</span><span class="tok-var">value</span><span class="tok-punc">:</span> <span class="tok-type">T</span><span class="tok-punc">)</span> <span class="tok-punc">{</span>
<span class="tok-kw">this</span><span class="tok-punc">.</span><span class="tok-var">content</span> <span class="tok-punc">=</span> <span class="tok-var">value</span><span class="tok-punc">;</span>
<span class="tok-punc">}</span>
<span class="tok-var">getContent</span><span class="tok-punc">():</span> <span class="tok-type">T</span> <span class="tok-punc">{</span>
<span class="tok-kw">return</span> <span class="tok-kw">this</span><span class="tok-punc">.</span><span class="tok-var">content</span><span class="tok-punc">;</span>
<span class="tok-punc">}</span>
<span class="tok-punc">}</span>
<span class="tok-kw">const</span> <span class="tok-var">numberBox</span> <span class="tok-punc">=</span> <span class="tok-kw">new</span> <span class="tok-var">Box</span><span class="tok-punc"><</span><span class="tok-type">number</span><span class="tok-punc">>(</span><span class="tok-num">123</span><span class="tok-punc">);</span>
<span class="tok-kw">const</span> <span class="tok-var">stringBox</span> <span class="tok-punc">=</span> <span class="tok-kw">new</span> <span class="tok-var">Box</span><span class="tok-punc"><</span><span class="tok-type">string</span><span class="tok-punc">>(</span><span class="tok-str">"TypeScript"</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">numberBox</span><span class="tok-punc">.</span><span class="tok-var">getContent</span><span class="tok-punc">(),</span> <span class="tok-var">stringBox</span><span class="tok-punc">.</span><span class="tok-var">getContent</span><span class="tok-punc">());</span></div>
<div class="console" id="boxConsole"></div>
</div>
<p class="note-line">T is fixed the moment you write new Box<number>() — content and getContent() both follow it.</p>
</div>
<div class="tab-panel" id="t2">
<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">pair.ts</span>
<button class="run-btn" id="pairBtn" 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">class</span> <span class="tok-type">Pair</span><span class="tok-punc"><</span><span class="tok-type">K</span><span class="tok-punc">,</span> <span class="tok-type">V</span><span class="tok-punc">></span> <span class="tok-punc">{</span>
<span class="tok-var">key</span><span class="tok-punc">:</span> <span class="tok-type">K</span><span class="tok-punc">;</span>
<span class="tok-var">value</span><span class="tok-punc">:</span> <span class="tok-type">V</span><span class="tok-punc">;</span>
<span class="tok-var">constructor</span><span class="tok-punc">(</span><span class="tok-var">key</span><span class="tok-punc">:</span> <span class="tok-type">K</span><span class="tok-punc">,</span> <span class="tok-var">value</span><span class="tok-punc">:</span> <span class="tok-type">V</span><span class="tok-punc">)</span> <span class="tok-punc">{</span>
<span class="tok-kw">this</span><span class="tok-punc">.</span><span class="tok-var">key</span> <span class="tok-punc">=</span> <span class="tok-var">key</span><span class="tok-punc">;</span>
<span class="tok-kw">this</span><span class="tok-punc">.</span><span class="tok-var">value</span> <span class="tok-punc">=</span> <span class="tok-var">value</span><span class="tok-punc">;</span>
<span class="tok-punc">}</span>
<span class="tok-punc">}</span>
<span class="tok-kw">const</span> <span class="tok-var">pair</span> <span class="tok-punc">=</span> <span class="tok-kw">new</span> <span class="tok-var">Pair</span><span class="tok-punc"><</span><span class="tok-type">string</span><span class="tok-punc">,</span> <span class="tok-type">number</span><span class="tok-punc">>(</span><span class="tok-str">"age"</span><span class="tok-punc">,</span> <span class="tok-num">25</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">pair</span><span class="tok-punc">.</span><span class="tok-var">key</span><span class="tok-punc">,</span> <span class="tok-var">pair</span><span class="tok-punc">.</span><span class="tok-var">value</span><span class="tok-punc">);</span></div>
<div class="console" id="pairConsole"></div>
</div>
<p class="note-line">K and V are supplied together at construction time, each independently typed.</p>
</div>
<div class="tab-panel" id="t3">
<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">collection.ts</span>
<button class="run-btn" id="colBtn" 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">class</span> <span class="tok-type">Collection</span><span class="tok-punc"><</span><span class="tok-type">T</span><span class="tok-punc">></span> <span class="tok-punc">{</span>
<span class="tok-kw">private</span> <span class="tok-var">items</span><span class="tok-punc">:</span> <span class="tok-type">T</span><span class="tok-punc">[]</span> <span class="tok-punc">=</span> <span class="tok-punc">[];</span>
<span class="tok-var">add</span><span class="tok-punc">(</span><span class="tok-var">item</span><span class="tok-punc">:</span> <span class="tok-type">T</span><span class="tok-punc">):</span> <span class="tok-type">void</span> <span class="tok-punc">{</span>
<span class="tok-kw">this</span><span class="tok-punc">.</span><span class="tok-var">items</span><span class="tok-punc">.</span><span class="tok-var">push</span><span class="tok-punc">(</span><span class="tok-var">item</span><span class="tok-punc">);</span>
<span class="tok-punc">}</span>
<span class="tok-var">getAll</span><span class="tok-punc">():</span> <span class="tok-type">T</span><span class="tok-punc">[]</span> <span class="tok-punc">{</span>
<span class="tok-kw">return</span> <span class="tok-kw">this</span><span class="tok-punc">.</span><span class="tok-var">items</span><span class="tok-punc">;</span>
<span class="tok-punc">}</span>
<span class="tok-punc">}</span>
<span class="tok-kw">const</span> <span class="tok-var">stringCollection</span> <span class="tok-punc">=</span> <span class="tok-kw">new</span> <span class="tok-var">Collection</span><span class="tok-punc"><</span><span class="tok-type">string</span><span class="tok-punc">>();</span>
<span class="tok-var">stringCollection</span><span class="tok-punc">.</span><span class="tok-var">add</span><span class="tok-punc">(</span><span class="tok-str">"apple"</span><span class="tok-punc">);</span>
<span class="tok-var">stringCollection</span><span class="tok-punc">.</span><span class="tok-var">add</span><span class="tok-punc">(</span><span class="tok-str">"banana"</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">stringCollection</span><span class="tok-punc">.</span><span class="tok-var">getAll</span><span class="tok-punc">());</span></div>
<div class="console" id="colConsole"></div>
</div>
<p class="note-line">Every method that touches T stays in sync — add() only accepts strings, getAll() only returns strings.</p>
</div>
<div class="tab-panel" id="t4">
<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">entity-manager.ts</span>
<button class="run-btn" id="emBtn" 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">HasId</span> <span class="tok-punc">{</span>
<span class="tok-var">id</span><span class="tok-punc">:</span> <span class="tok-type">number</span><span class="tok-punc">;</span>
<span class="tok-punc">}</span>
<span class="tok-kw">class</span> <span class="tok-type">EntityManager</span><span class="tok-punc"><</span><span class="tok-type">T</span> <span class="tok-kw">extends</span> <span class="tok-type">HasId</span><span class="tok-punc">></span> <span class="tok-punc">{</span>
<span class="tok-kw">private</span> <span class="tok-var">entities</span><span class="tok-punc">:</span> <span class="tok-type">T</span><span class="tok-punc">[]</span> <span class="tok-punc">=</span> <span class="tok-punc">[];</span>
<span class="tok-var">add</span><span class="tok-punc">(</span><span class="tok-var">entity</span><span class="tok-punc">:</span> <span class="tok-type">T</span><span class="tok-punc">)</span> <span class="tok-punc">{</span>
<span class="tok-kw">this</span><span class="tok-punc">.</span><span class="tok-var">entities</span><span class="tok-punc">.</span><span class="tok-var">push</span><span class="tok-punc">(</span><span class="tok-var">entity</span><span class="tok-punc">);</span>
<span class="tok-punc">}</span>
<span class="tok-var">getById</span><span class="tok-punc">(</span><span class="tok-var">id</span><span class="tok-punc">:</span> <span class="tok-type">number</span><span class="tok-punc">):</span> <span class="tok-type">T</span> <span class="tok-punc">|</span> <span class="tok-kw">undefined</span> <span class="tok-punc">{</span>
<span class="tok-kw">return</span> <span class="tok-kw">this</span><span class="tok-punc">.</span><span class="tok-var">entities</span><span class="tok-punc">.</span><span class="tok-var">find</span><span class="tok-punc">(</span><span class="tok-var">e</span> <span class="tok-punc">=></span> <span class="tok-var">e</span><span class="tok-punc">.</span><span class="tok-var">id</span> <span class="tok-punc">===</span> <span class="tok-var">id</span><span class="tok-punc">);</span>
<span class="tok-punc">}</span>
<span class="tok-punc">}</span>
<span class="tok-kw">const</span> <span class="tok-var">manager</span> <span class="tok-punc">=</span> <span class="tok-kw">new</span> <span class="tok-var">EntityManager</span><span class="tok-punc"><{</span> <span class="tok-var">id</span><span class="tok-punc">:</span> <span class="tok-type">number</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">manager</span><span class="tok-punc">.</span><span class="tok-var">add</span><span class="tok-punc">({</span> <span class="tok-var">id</span><span class="tok-punc">:</span> <span class="tok-num">1</span><span class="tok-punc">,</span> <span class="tok-var">name</span><span class="tok-punc">:</span> <span class="tok-str">"Tisha"</span> <span class="tok-punc">});</span>
<span class="tok-var">manager</span><span class="tok-punc">.</span><span class="tok-var">add</span><span class="tok-punc">({</span> <span class="tok-var">id</span><span class="tok-punc">:</span> <span class="tok-num">2</span><span class="tok-punc">,</span> <span class="tok-var">name</span><span class="tok-punc">:</span> <span class="tok-str">"Priya"</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">manager</span><span class="tok-punc">.</span><span class="tok-var">getById</span><span class="tok-punc">(</span><span class="tok-num">2</span><span class="tok-punc">));</span></div>
<div class="console" id="emConsole"></div>
</div>
<p class="note-line">extends HasId means whatever T is, EntityManager can always rely on entity.id existing.</p>
</div>
<div class="tab-panel" id="t5">
<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">api-response.ts</span>
<button class="run-btn" id="apiBtn" 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">class</span> <span class="tok-type">ApiResponse</span><span class="tok-punc"><</span><span class="tok-type">T</span> <span class="tok-punc">=</span> <span class="tok-kw">any</span><span class="tok-punc">></span> <span class="tok-punc">{</span>
<span class="tok-var">constructor</span><span class="tok-punc">(</span><span class="tok-kw">public</span> <span class="tok-var">data</span><span class="tok-punc">:</span> <span class="tok-type">T</span><span class="tok-punc">,</span> <span class="tok-kw">public</span> <span class="tok-var">success</span><span class="tok-punc">:</span> <span class="tok-type">boolean</span><span class="tok-punc">)</span> <span class="tok-punc">{}</span>
<span class="tok-punc">}</span>
<span class="tok-kw">const</span> <span class="tok-var">response</span> <span class="tok-punc">=</span> <span class="tok-kw">new</span> <span class="tok-var">ApiResponse</span><span class="tok-punc">(</span><span class="tok-str">"All good!"</span><span class="tok-punc">,</span> <span class="tok-kw">true</span><span class="tok-punc">);</span> <span class="tok-cmt">// T = string</span>
<span class="tok-kw">const</span> <span class="tok-var">defaultResponse</span> <span class="tok-punc">=</span> <span class="tok-kw">new</span> <span class="tok-var">ApiResponse</span><span class="tok-punc">(</span><span class="tok-num">123</span><span class="tok-punc">,</span> <span class="tok-kw">true</span><span class="tok-punc">);</span> <span class="tok-cmt">// T = number</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">response</span><span class="tok-punc">.</span><span class="tok-var">data</span><span class="tok-punc">,</span> <span class="tok-var">response</span><span class="tok-punc">.</span><span class="tok-var">success</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">defaultResponse</span><span class="tok-punc">.</span><span class="tok-var">data</span><span class="tok-punc">,</span> <span class="tok-var">defaultResponse</span><span class="tok-punc">.</span><span class="tok-var">success</span><span class="tok-punc">);</span></div>
<div class="console" id="respConsole"></div>
</div>
<p class="note-line">T is inferred from each constructor call here — the default only kicks in when nothing else can be inferred.</p>
</div>
<script>
(function () {
var wrapper = document.currentScript.closest('.infographic-ts')
|| document.querySelector('.infographic-ts');
var root = wrapper;
var tabBtns = root.querySelectorAll('.tab-btn');
var panels = root.querySelectorAll('.tab-panel');
tabBtns.forEach(function (btn) {
btn.addEventListener('click', function () {
var target = btn.getAttribute('data-tab');
tabBtns.forEach(function (b) { b.classList.toggle('active', b === btn); });
panels.forEach(function (p) { p.classList.toggle('active', p.id === target); });
});
});
function line(consoleEl, cls, text) {
var el = document.createElement('div');
el.className = 'console-line ' + (cls || '');
el.textContent = text;
consoleEl.appendChild(el);
}
function bind(id, consoleId, cb) {
var btn = root.querySelector('#' + id);
var c = root.querySelector('#' + consoleId);
btn.addEventListener('click', function () {
c.innerHTML = '';
c.classList.add('show');
cb(c);
setTimeout(function () {
c.scrollIntoView({ behavior: 'smooth', block: 'end' });
}, 50);
});
}
bind('boxBtn', 'boxConsole', function (c) {
line(c, 'ok', '123 TypeScript');
});
bind('pairBtn', 'pairConsole', function (c) {
line(c, 'ok', 'age 25');
});
bind('colBtn', 'colConsole', function (c) {
line(c, 'ok', "[ 'apple', 'banana' ]");
});
bind('emBtn', 'emConsole', function (c) {
line(c, 'ok', "{ id: 2, name: 'Priya' }");
});
bind('apiBtn', 'respConsole', function (c) {
line(c, 'ok', 'All good! true');
line(c, 'ok', '123 true');
});
})();
</script>
</div>📌 Summary
Feature | Example |
|---|---|
Single Generic |
|
Multiple Generics |
|
Generic Methods |
|
Constraints |
|
Default Type |
|
💡 Use Cases
Data managers (e.g.,
EntityManager<T>)Form handlers
Caching layers
API response models
Stacks, queues, collections