Перейти к основному содержимому

createApi

Способ массового создания событий-команд для обновления стора на основе объекта с функциями-обработчиками. Если стор принадлежит какому-либо домену, то новые события также будут принадлежать ему

Формула

declare const $store: Store<T> // управляемый стор

const api: {
event1: Event<S> // созданное событие-команда
event2: Event<Q> // созданное событие-команда
} = createApi(
/*store*/ $store,
/*handlers*/ {
event1: /*handler*/ (state: T, data: S) => T,
event2: /*handler*/ (state: T, data: Q) => T,
},
)

Аргументы

  1. store: Стор, чьим значением требуется управлять

  2. handlers: Объект с функциями-обработчиками, на каждую функцию будет создано по событию

    handler: (state: T, data: S) => T

    Функция-обработчик, которая будет вычислять новое состояние store на основе его предыдущего состояния и данных, отправленных в полученное событие-команду, должна быть чистой

    Аргументы

    • state: Текущее состояние стора
    • data: Значение, с которым было вызвано событие

    Возвращает

    Новое значение для хранения в store. Если функция возвращает undefined или текущее состояние стора, то обновления не будет

Возвращает

Объект с событиями, по событию на каждый переданный обработчик

Примеры

Управление позицией игрока

import {createStore, createApi} from 'effector'

const playerPosition = createStore(0)

const api = createApi(playerPosition, {
moveLeft: (pos, n) => pos - n,
moveRight: (pos, n) => pos + n,
})

playerPosition.watch(pos => {
console.log('position', pos)
})
// => position 0

api.moveRight(10)
// => position 10

api.moveLeft(5)
// => position 5

Запустить пример