TypeScript 5.3–5.4: nova restrição de tipos e NoInfer

Visão geral do TypeScript 5.3

// npm install typescript@5.3

Aprimoramento do refinamento em switch/case

type Result = { status: "ok"; data: string } | { status: "err"; code: number };

function handle(r: Result) {
  switch (r.status) {
    case "ok":
      console.log(r.data);   // r: { status: "ok"; data: string } — narrowed
      break;
    case "err":
      console.log(r.code);   // r: { status: "err"; code: number } — narrowed
      break;
  }
}

Importação de tipo no JSDoc

/** @import { User } from "./types.js" */

/** @param {User} user */
function greet(user) {
  console.log(user.name);
}

Modo de resolução em importação de tipo

import type { User } from "some-library" with { "resolution-mode": "require" };

Visão geral do TypeScript 5.4

// npm install typescript@5.4

Tipo utilitário NoInfer<T>

function createStore<T>(initial: T, onChange: (val: NoInfer<T>) => void) {
  // T inferred from initial, not from onChange callback
}

createStore({ count: 0 }, (val) => {
  // val: { count: number } — inferred from initial only
});

Por que NoInfer é importante

// Before NoInfer: T may be widened by the callback
function createStore<T>(initial: T, onChange: (val: T) => void) {}
createStore({ count: 0 }, (val: { count: number; extra: string }) => {});
// T widened to include extra — not what we want

Refinamento preservado após fechamentos

function process(val: string | null) {
  if (!val) return;
  // val: string
  setTimeout(() => {
    console.log(val.toUpperCase()); // TS 5.4: still string — not widened
  }, 100);
}

Tipagem de Object.groupBy

const users = [
  { name: "Alice", role: "admin" },
  { name: "Bob", role: "user" },
];
const grouped = Object.groupBy(users, (u) => u.role);
// grouped: { [role: string]: { name: string; role: string }[] }

Geração aprimorada de declarações

// Fewer "Type ... is not assignable to type ..." errors
// in generated declaration files from TS 5.4 onward

Recapitulação: TS 5.3–5.4

Verificação rápida

O que você aprendeu