@hashiprobr/react-use-mount-and-update v1.1.0

react-use-mount-and-update

React Hooks for separating different responsibilities of effects

The useEffect React Hook is commonly used in one of the following ways:

1. with an empty dependency array, for effects that should occur only the first time the component is mounted;

2. with a non-empty dependency array, for effects that should occur when the component is mounted and one of the dependencies changed.

This module provides React Hooks that separate these usages, for improving semantic distinction, reducing dependency mistakes, and avoiding memory leaks.

• Calling useMount is equivalent to calling useEffect with an empty dependency array. It does not need a second argument.

• Calling useUpdate is equivalent to calling useEffect, but throws an error if the second argument is not a non-empty array. It also ensures that the effect does not occur if the component is not mounted.

Peer dependencies

{
    "react": "^17.0.2"
}

Install

With npm:

npm install @hashiprobr/react-use-mount-and-update

With yarn:

yarn add @hashiprobr/react-use-mount-and-update

Example of useMount

The code below...

import { useMount } from '@hashiprobr/react-use-mount-and-update';

export default function MyComponent() {
    /* ... */

    useMount(() => {
        console.log('hello world');
    }); // second argument is not necessary

    /* ... */
}

...is equivalent to the code below.

import { useEffect } from 'react';

export default function MyComponent() {
    /* ... */

    useEffect(() => {
        console.log('hello world');
    }, []); // second argument is an empty array

    /* ... */
}

Example of useUpdate

The code below...

import { useUpdate } from '@hashiprobr/react-use-mount-and-update';

export default function MyComponent() {
    /* ... */

    useUpdate(() => {
        console.log('hello world');
    }, [a, b]); // second argument is a non-empty array

    /* ... */
}

...is almost equivalent to the code below...

import { useEffect } from 'react';

export default function MyComponent() {
    /* ... */

    useEffect(() => {
        console.log('hello world');
    }, [a, b]); // second argument is a non-empty array

    /* ... */
}

...but in the first one the effect will occur only if the component is mounted, while in the second one the effect will occur regardless if the component is mounted or not.

Also, all codes below throw an error.

useUpdate(() => {
    console.log('hello world');
}); // second argument must exist

useUpdate(() => {
    console.log('hello world');
}, '[a, b]'); // second argument must be an array

useUpdate(() => {
    console.log('hello world');
}, []); // second argument must be non-empty