Custom hooks in TypeScript

What to do when TypeScript complains about the return type of your custom hook.September 25, 2020

I learned a cool TypeScript tip while I was trying to write a hook to manage the state of a RadioList component.

My hook was pretty straightforward. It looked something like this:

export function useRadioList(defaultValue: string) { const [selectedValue, setSelectedValue] = React.useState<string>( defaultValue ); const updateSelectedValue = (value: string) => setSelectedValue(value); return [selectedValue, updateSelectedValue]; }

I tried to use the hook, and I got a typescript error:

const [selectedValue, updateSelectedValue] = useRadioList("first-option");
This expression is not callable. Not all constituents of type 'string | ((value: string) => void)' are callable. Type 'string' has no call signatures. ts(2349)

The main part of the TypeScript error that we need to focus on is this: Not all constituents of type 'string | ((value: string) => void)' are callable.

Because we are returning a tuple from the useRadioList hook, and not explicitly typing the return type of the hook, TypeScript infers that it's an array, which can contain an infinite number of elements.

TypeScript can't tell if updateSelectedValue is a string or a function.

There are two ways to fix this problem:

  1. I can be explicit about the return type of the useRadioList hook
export function useRadioList( defaultValue: string ): [string, (value: string) => void] { const [selectedValue, setSelectedValue] = React.useState<string>( defaultValue ); const updateSelectedValue = (value: string) => setSelectedValue(value); return [selectedValue, updateSelectedValue]; }
  1. I can pair a type assertion with the const keyword
export function useRadioList(defaultValue: string) { const [selectedValue, setSelectedValue] = React.useState<string>( defaultValue ); const updateSelectedValue = (value: string) => setSelectedValue(value); return [selectedValue, updateSelectedValue] as const; }

Either way, TypeScript now knows that useRadioList returns an array with two elements in it. The first one is always a string, and the second one is always a function.

Continue Reading

css architecturedesign systemsfrontend platform

Deep Dive Into the Cascade: Use the @layer Rule to Write More Deterministic CSS

Read Post