• This is not a core part of ember-resources, but is an example utility to demonstrate a concept when authoring your own resources. However, this utility is still under the broader library's SemVer policy.

    A consuming app will not pay for the bytes of this utility unless imported.

    A utility for debouncing high-frequency updates. The returned value will only be updated every ms and is initially undefined.

    This can be useful when a user's typing is updating a tracked property and you want to derive data less frequently than on each keystroke.

    Note that this utility requires the @use decorator (debounce could be implemented without the need for the @use decorator but the current implementation is 8 lines)

    Type Parameters

    • Value = unknown

    Parameters

    • ms: number

      delay in milliseconds to wait before updating the returned value

    • thunk: (() => Value)

      function that returns the value to debounce

        • (): Value
        • Returns Value

    Returns undefined | Value

    Example

     import Component from '@glimmer/component';
    import { tracked } from '@glimmer/tracking';
    import { debounce } from 'ember-resources/util/debounce';

    const delay = 100; // ms

    class Demo extends Component {
    @tracked userInput = '';

    @use debouncedInput = debounce(delay, () => this.userInput);
    }

    Example

    This could be further composed with RemoteData

     import Component from '@glimmer/component';
    import { tracked } from '@glimmer/tracking';
    import { debounce } from 'ember-resources/util/debounce';
    import { RemoteData } from 'ember-resources/util/remote-data';

    const delay = 100; // ms

    class Demo extends Component {
    @tracked userInput = '';

    @use debouncedInput = debounce(delay, () => this.userInput);

    @use search = RemoteData(() => `https://my.domain/search?q=${this.debouncedInput}`);
    }

Generated using TypeDoc