π Object type annotations tell TypeScript what properties an object should have and what types those properties should be.
β Basic Syntax
let user: { name: string; age: number; isAdmin: boolean; } = { name: "Alice", age: 30, isAdmin: true };β If you try to add extra fields or use the wrong types, TypeScript will throw errors.
π Optional Properties
Use ? to mark properties as optional:
let user: { name: string; age?: number } = { name: "Bob" };βπ Readonly Properties
Use readonly to prevent changes:
let config: {
readonly version: string;
debug: boolean;
} = {
version: "1.0",
debug: true
};
// config.version = "2.0"; // β Error: Cannot assign to 'version'β Function Types in Objects
You can annotate functions inside objects like this:
let person: { name: string; greet: (msg: string) => string; } = { name: "Codeveda", greet: (msg) => Hello, ${msg} };β Using type Alias
To reuse object shapes:
type User = { name: string; age: number; };
let u1: User = { name: "Alice", age: 25 };
let u2: User = { name: "Bob", age: 30 };βπ§ With interface (Alternative to type)
interface Product {
id: number;
title: string;
inStock: boolean;
}
const item: Product = {
id: 101,
title: "Notebook",
inStock: true
};β interface is great for OOP-style code and can be extended.
π₯ Index Signature (for dynamic object keys)
let errorBag: { [key: string]: string; } = { email: "Invalid email", username: "Must be at least 3 characters" };<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-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); }
.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; }
</style>
<div class="tabs">
<button class="tab-btn active" data-tab="t1" type="button">Basic & optional</button>
<button class="tab-btn" data-tab="t2" type="button">Readonly & functions</button>
<button class="tab-btn" data-tab="t3" type="button">type & interface</button>
<button class="tab-btn" data-tab="t4" type="button">Index signatures</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">basic.ts</span>
<button class="run-btn" id="basicBtn" 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">let</span> <span class="tok-var">user</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-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-var">isAdmin</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-var">name</span><span class="tok-punc">:</span> <span class="tok-str">"Alice"</span><span class="tok-punc">,</span>
<span class="tok-var">age</span><span class="tok-punc">:</span> <span class="tok-num">30</span><span class="tok-punc">,</span>
<span class="tok-var">isAdmin</span><span class="tok-punc">:</span> <span class="tok-kw">true</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">user</span><span class="tok-punc">.</span><span class="tok-var">name</span><span class="tok-punc">,</span> <span class="tok-var">user</span><span class="tok-punc">.</span><span class="tok-var">age</span><span class="tok-punc">,</span> <span class="tok-var">user</span><span class="tok-punc">.</span><span class="tok-var">isAdmin</span><span class="tok-punc">);</span></div>
<div class="console" id="basicConsole"></div>
</div>
<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">optional.ts</span>
<button class="run-btn" id="optBtn" 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">let</span> <span class="tok-var">user</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-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-punc">=</span> <span class="tok-punc">{</span> <span class="tok-var">name</span><span class="tok-punc">:</span> <span class="tok-str">"Bob"</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">user</span><span class="tok-punc">.</span><span class="tok-var">name</span><span class="tok-punc">,</span> <span class="tok-var">user</span><span class="tok-punc">.</span><span class="tok-var">age</span><span class="tok-punc">);</span></div>
<div class="console" id="optConsole"></div>
</div>
<p class="note-line">Extra fields or wrong types on the object literal would fail to compile — the shape is enforced both ways.</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">readonly.ts</span>
<button class="run-btn" id="roBtn" 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">let</span> <span class="tok-var">config</span><span class="tok-punc">:</span> <span class="tok-punc">{</span>
<span class="tok-kw">readonly</span> <span class="tok-var">version</span><span class="tok-punc">:</span> <span class="tok-type">string</span><span class="tok-punc">;</span>
<span class="tok-var">debug</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-punc">{</span>
<span class="tok-var">version</span><span class="tok-punc">:</span> <span class="tok-str">"1.0"</span><span class="tok-punc">,</span>
<span class="tok-var">debug</span><span class="tok-punc">:</span> <span class="tok-kw">true</span>
<span class="tok-punc">};</span>
<span class="tok-var">config</span><span class="tok-punc">.</span><span class="tok-var">version</span> <span class="tok-punc">=</span> <span class="tok-str">"2.0"</span><span class="tok-punc">;</span></div>
<div class="console" id="roConsole"></div>
</div>
<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">function-in-object.ts</span>
<button class="run-btn" id="fnObjBtn" 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">let</span> <span class="tok-var">person</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-type">string</span><span class="tok-punc">;</span>
<span class="tok-var">greet</span><span class="tok-punc">:</span> <span class="tok-punc">(</span><span class="tok-var">msg</span><span class="tok-punc">:</span> <span class="tok-type">string</span><span class="tok-punc">)</span> <span class="tok-punc">=></span> <span class="tok-type">string</span><span class="tok-punc">;</span>
<span class="tok-punc">}</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">"Codeveda"</span><span class="tok-punc">,</span>
<span class="tok-var">greet</span><span class="tok-punc">:</span> <span class="tok-punc">(</span><span class="tok-var">msg</span><span class="tok-punc">)</span> <span class="tok-punc">=></span> <span class="tok-str">`Hello, ${</span><span class="tok-var">msg</span><span class="tok-str">}`</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">person</span><span class="tok-punc">.</span><span class="tok-var">greet</span><span class="tok-punc">(</span><span class="tok-str">"world"</span><span class="tok-punc">));</span></div>
<div class="console" id="fnObjConsole"></div>
</div>
</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">type-alias.ts</span>
<button class="run-btn" id="typeBtn" 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">type</span> <span class="tok-type">User</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-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-kw">let</span> <span class="tok-var">u1</span><span class="tok-punc">:</span> <span class="tok-type">User</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">"Alice"</span><span class="tok-punc">,</span> <span class="tok-var">age</span><span class="tok-punc">:</span> <span class="tok-num">25</span> <span class="tok-punc">};</span>
<span class="tok-kw">let</span> <span class="tok-var">u2</span><span class="tok-punc">:</span> <span class="tok-type">User</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">"Bob"</span><span class="tok-punc">,</span> <span class="tok-var">age</span><span class="tok-punc">:</span> <span class="tok-num">30</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">u1</span><span class="tok-punc">.</span><span class="tok-var">name</span><span class="tok-punc">,</span> <span class="tok-var">u2</span><span class="tok-punc">.</span><span class="tok-var">name</span><span class="tok-punc">);</span></div>
<div class="console" id="typeConsole"></div>
</div>
<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">interface.ts</span>
<button class="run-btn" id="ifaceBtn" 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">Product</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">title</span><span class="tok-punc">:</span> <span class="tok-type">string</span><span class="tok-punc">;</span>
<span class="tok-var">inStock</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-kw">const</span> <span class="tok-var">item</span><span class="tok-punc">:</span> <span class="tok-type">Product</span> <span class="tok-punc">=</span> <span class="tok-punc">{</span>
<span class="tok-var">id</span><span class="tok-punc">:</span> <span class="tok-num">101</span><span class="tok-punc">,</span>
<span class="tok-var">title</span><span class="tok-punc">:</span> <span class="tok-str">"Notebook"</span><span class="tok-punc">,</span>
<span class="tok-var">inStock</span><span class="tok-punc">:</span> <span class="tok-kw">true</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">item</span><span class="tok-punc">.</span><span class="tok-var">title</span><span class="tok-punc">,</span> <span class="tok-var">item</span><span class="tok-punc">.</span><span class="tok-var">inStock</span><span class="tok-punc">);</span></div>
<div class="console" id="ifaceConsole"></div>
</div>
<p class="note-line">Both describe the same kind of shape. interface can be extended and merged, which suits OOP-style code; type is more flexible for unions and other compositions.</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">index-signature.ts</span>
<button class="run-btn" id="idxBtn" 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">let</span> <span class="tok-var">errorBag</span><span class="tok-punc">:</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">string</span><span class="tok-punc">]:</span> <span class="tok-type">string</span> <span class="tok-punc">}</span> <span class="tok-punc">=</span> <span class="tok-punc">{</span>
<span class="tok-var">email</span><span class="tok-punc">:</span> <span class="tok-str">"Invalid email"</span><span class="tok-punc">,</span>
<span class="tok-var">username</span><span class="tok-punc">:</span> <span class="tok-str">"Must be at least 3 characters"</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">errorBag</span><span class="tok-punc">.</span><span class="tok-var">email</span><span class="tok-punc">);</span>
<span class="tok-var">errorBag</span><span class="tok-punc">.</span><span class="tok-var">password</span> <span class="tok-punc">=</span> <span class="tok-str">"Too short"</span><span class="tok-punc">;</span></div>
<div class="console" id="idxConsole"></div>
</div>
<p class="note-line">Any string key is allowed, as long as its value is a string — useful when the keys aren't known ahead of time.</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);
});
}
bind('basicBtn', 'basicConsole', function (c) {
line(c, 'ok', 'Alice 30 true');
});
bind('optBtn', 'optConsole', function (c) {
line(c, 'ok', 'Bob undefined');
});
bind('roBtn', 'roConsole', function (c) {
line(c, 'err', "config.version = \"2.0\" \u2192 Error: Cannot assign to 'version' because it is a read-only property.");
});
bind('fnObjBtn', 'fnObjConsole', function (c) {
line(c, 'ok', 'person.greet("world") \u2192 "Hello, world"');
});
bind('typeBtn', 'typeConsole', function (c) {
line(c, 'ok', 'Alice Bob');
});
bind('ifaceBtn', 'ifaceConsole', function (c) {
line(c, 'ok', 'Notebook true');
});
bind('idxBtn', 'idxConsole', function (c) {
line(c, 'ok', 'errorBag.email \u2192 "Invalid email"');
line(c, 'ok', 'errorBag.password = "Too short" \u2192 OK, key added at runtime');
});
})();
</script>
</div>β Summary Table
Feature | Syntax Example |
|---|---|
Basic | { name: string; age: number } |
Optional | age?: number |
Readonly | readonly id: string |
Method | greet: (msg: string) => void |
Reuse | type User = { ... } or interface User { ... } |
Dynamic keys | [key: string]: string |