Skip to main content

64 docs tagged with "typescript"

View all tags

Advanced functions

In this chapter, you learn more advanced features of functions in TypeScript.

Advanced type operations

In this chapter, you learn about TypeScript's advanced type operation features. Combining them lets you write more type-safe and expressive code.

Class basics

In this chapter, you learn the basics of how to write classes in TypeScript.

Classes and interfaces

Designing classes and interfaces in TypeScript. Explains information hiding (encapsulation) / single responsibility / keeping classes small / preferring composition over inheritance with Bad / Good comparisons. Also covers the ideas of cohesion and coupling.

Clean Code Guide

A practical guide to writing clean, maintainable TypeScript. It explains step by step why each rule matters and how to apply it. A roadmap that organizes design principles for leveraging the type system across 13 articles.

Comments

The art of comments in TypeScript. The core principle that Why goes in comments and What goes in code, plus patterns to keep stale comments from contradicting the code during maintenance. Also covers using JSDoc and writing self-documenting code.

Conditionals

Best practices for conditional branching in TypeScript. A guide to keeping nesting shallow with early returns, discriminated unions and exhaustiveness checks, and reducing if statements with polymorphism, explained with Bad / Good comparisons.

Conflicts and limits — deciding which one to take

The five principles pull against each other. Push splitting and a change touches more files; interpose an abstraction and it takes more steps to trace what actually runs. This chapter covers how to decide when they conflict, and modern criticism of SOLID itself.

Decorator — A Pattern Distinct from TC39 Decorators

Despite the shared name, GoF's Decorator pattern and TypeScript's Decorators syntax are different concepts. This chapter separates the two, then compares the pattern with composition through higher-order functions.

Defining functions

Best practices for designing functions in TypeScript. Compares single responsibility / pure functions / early return / minimizing arguments / avoiding side effects / the DRY principle with Bad / Good examples. Also covers clarifying input and output with type annotations.

Defining variables

Best practices for defining variables in TypeScript. Explains turning magic numbers / magic characters into constants, choosing between const and let, minimizing scope, and not giving a variable multiple meanings, using Bad / Good comparisons.

Design & Quality

A hub for the domain covering how code is written and structured. It spans everyday decisions such as naming and splitting functions, a closer look at the SOLID principles, a rereading of the GoF patterns in modern TypeScript, and what changes when the test comes first.

Design patterns — four archetypes and their vocabulary

This chapter presents Strategy, Singleton, Observer, and Abstract Factory from the problems each was designed to solve. It covers commonly conflated pairs like Strategy vs. State, Observer vs. polling, and Abstract Factory vs. Factory Method.

Development toolchain

In this chapter, you learn about the development tools used in a TypeScript project.

Function basics

In this chapter, you learn the basics of writing functions in TypeScript.

Generic constraints

In this chapter, you learn how to add constraints to generics, plus generic classes and interfaces.

Generics basics

In this chapter, you learn about generics, one of TypeScript's signature features.

Loops

How to choose between forEach / map / filter / reduce and the difference between for...of and for...in. Explains array-processing best practices that make intent clear with higher-order functions, using Bad / Good comparisons.

Mapped Types and Conditional Types

In this chapter, you learn about TypeScript's advanced type features, Mapped Types and Conditional Types. Once you understand them, you can create your own utility types.

Modules and tsconfig

In this chapter, you learn about TypeScript's module system and project configuration.

Naming conventions 1: case conventions, variables, and constants

Naming conventions in TypeScript, Part 1. Explains how to choose among the four case conventions (kebab, snake, Pascal, camel) and how to name variables, booleans, and constants, using Bad / Good comparisons. The gateway to naming well, so the code itself becomes documentation.

Naming conventions 2: functions and classes

Naming conventions in TypeScript, Part 2. Explains naming functions with verb patterns such as get / set / calculate, functions that return a boolean, suffix patterns for class names, and the criteria for not making method names redundant, using Bad / Good comparisons.

Naming conventions 3: improving naming quality

Naming conventions in TypeScript, Part 3. Covers principles that improve naming quality, such as pronounceable names, plural forms for arrays, unifying synonyms, contrasting words, avoiding meaningless words, and criteria for abbreviation, plus a comprehensive exercise and a quick reference summary.

Programming Languages

A hub for the domain covering language specifications themselves, JavaScript and TypeScript. It spans the foundation of variables, functions, and objects through to the type system and generics.

React + TypeScript

In this chapter, you learn type-safe frontend development that combines React and TypeScript.

Schema validation with Zod

Define schemas with Zod and learn type inference, React Hook Form integration, and runtime validation of API responses.

Singleton — How Far a Module's Single Instance Reaches

An ES module is evaluated only once as long as it resolves to the same URL, so you get a single instance without writing a Singleton class. This chapter maps how far that guarantee reaches and when you still need another approach.

SOLID principles

Explains the five SOLID principles of object-oriented design (single responsibility / open-closed / Liskov substitution / interface segregation / dependency inversion) with TypeScript examples. An introductory guide that contrasts each principle with Bad / Good code.

SOLID Principles in Depth

A seven-chapter series that digs into the five SOLID principles across three layers, why you follow them, when it's OK to break them, and how they get misused. Each chapter goes to the original text of the principle and covers how it is reassessed today.

Special types

In this chapter, you learn about TypeScript's special types.

Strategy — Functions Being First-Class

If all you do is swap behavior, passing a function is enough. What still makes you want to bundle things into an object is a strategy that carries several methods or state.

Summary

A recap of all 11 articles in the Clean Code Guide (TypeScript). It visualizes the big picture of naming, functions, type safety, object orientation, and the SOLID principles as a mindmap, and serves as a checklist to use while coding.

Type narrowing

In this chapter, you learn about "type narrowing," which is at the core of TypeScript's type system.

TypeScript Design Patterns

A 16-chapter guide that rereads the 23 GoF patterns in modern TypeScript. Each chapter judges whether language features can replace the pattern, and lays out the conditions under which writing it as a class still pays off.

TypeScript Guide

A 21-chapter guide that teaches TypeScript systematically, from the language spec to real-world practice. It progressively covers getting started, basic types, functions, classes and OOP, the advanced type system, generics, the development environment, and practical projects.

TypeScript-specific best practices

Best practices for using the TypeScript type system effectively. Explains avoiding any, choosing between unknown and never, generics, utility types, and narrowing with type guards, using Bad / Good comparisons.

Union types, literal types, and enums

In this chapter, you learn about union types that combine multiple types, literal types that allow only specific values, and enums that group related constants.

Utility types

In this chapter, you learn about the utility types built into TypeScript.

What is TypeScript? Setup

In this chapter, you learn the basic concepts of TypeScript and how to set up a development environment.