JavaScript & TypeScript

Types, asynchronous code, modules and JavaScript runtime edge cases.

100 troubleshooting guides · Page 4 / 5

73. Why does destructuring a discriminated union sometimes lose payload narrowing?

    Modern TypeScript can track certain const-destructured discriminants, but reassignment or separating correlated values can break that relationship.

74. Why is an array not accepted where a function requires a two-item tuple?

    An array type does not guarantee length or positional types.

75. Why can JavaScript still mutate a TypeScript Readonly object?

    Readonly is a compile-time restriction and is shallow.

76. Why does Partial not make nested update fields optional?

    Partial transforms only the top-level properties.

77. How do I get the resolved return type of an async loader?

    Use Awaited<ReturnType<typeof load>> on TypeScript versions supporting Awaited.

78. Why does a default argument widen the allowed values of a generic selector?

    Inference may use both the choices and default arguments.

79. Why does a function overload reject a union argument accepted by its implementation?

    Callers see overload signatures, not the implementation signature.

80. Why does a conditional type split a union into separate results?

    A conditional over a naked type parameter distributes across union members.

81. Why does keyof on an enum not produce the enum member names?

    For enum member names use keyof typeof Status: typeof obtains the enum object type, then keyof reads its keys.

82. Why does Object.values of a numeric enum contain both names and numbers?

    Numeric enums emit reverse mappings.

83. How do I type event names derived from a fixed property-name union?

    Use a template literal type when Field is a bounded string union: Keep runtime event registration synchronized with that model.

84. Why does adding a property to Window in one file not affect other modules?

    A module-local interface does not automatically augment the global Window.

85. Why does TypeScript say document or fetch does not exist in a browser project?

    Check the effective lib configuration and installed type packages.

86. Why do test globals disappear after setting compilerOptions.types?

    An explicit types list limits which ambient packages are included.

87. Does skipLibCheck fix conflicting versions of a dependency’s types?

    It skips declaration-file checking rather than reconciling incompatible definitions.

88. Why does TypeScript resolve an import that Node cannot load?

    Module resolution must model the actual runtime or bundler.

89. Why does a relative TypeScript import need a .js extension in Node ESM?

    The import specifier describes the runtime file that Node will load after compilation.

90. Why must I use import type after enabling verbatimModuleSyntax?

    The compiler preserves imports according to explicit syntax.

91. Why does code pass tsc but fail a single-file transpiler?

    Some TypeScript constructs need cross-file knowledge.

92. Why does importing JSON compile but fail in the deployed runtime?

    resolveJsonModule supplies TypeScript resolution and types, not a universal runtime loader.

93. Why does a default import from a CommonJS package fail despite type-checking?

    Inspect the package’s actual exports and the emitted interoperability helpers.

94. Why does an import work on Windows but fail in Linux CI?

    Check filename casing against every import.

95. Why does rootDir report a file outside the source tree despite exclude?

    Imported files become part of the program even when exclude filters discovery.

96. Why does a TypeScript path alias remain unresolved in compiled JavaScript?

    paths helps TypeScript resolve names; it does not rewrite emitted specifiers.

Ask your own question · Sign in to post questions and answers.