forward({from, to})

Sends data from one entity to another.

Note: If you want forward from store to store, there is your store from must change. Let's see example 1 below.

Arguments

  1. opts (Object): Object of kind {from: A, to: B}, where from and to are units.

Returns

(Subscription): Unsubscribe function

Example 1

Send store data to store

import {createStore, createEvent, forward} from 'effector'
const a = createStore(1)
const b = createStore(2)
const event = createEvent('event')
forward({
from: a,
to: b,
})
b.watch(state => console.log('state b: ', state))
// state b: 11
/* A snippet at the top is equivalent to a snippet at the bottom */
b.on(a, (state, valueFromA) => valueFromA).watch(state =>
console.log('state b: ', state),
)
// state b: 11
a.on(event, state => state + 10)
event()

Try it

Example 2

Send event data to store

import {createEvent, createStore, forward} from 'effector'
const event = createEvent()
const proxy = createStore(-1)
proxy.watch(data => console.log('data: ', data))
// data: -1
// data: 1
forward({
from: event,
to: proxy,
})
event(1)
event(1)

Try it

Example 3

Arrays to forward

import {createEvent, forward} from 'effector'
const firstSource = createEvent()
const secondSource = createEvent()
const firstTarget = createEvent()
const secondTarget = createEvent()
forward({
from: [firstSource, secondSource],
to: [firstTarget, secondTarget],
})
firstTarget.watch(e => console.log('first target', e))
secondTarget.watch(e => console.log('second target', e))
firstSource('A')
// => first target A
// => second target A
secondSource('B')
// => first target B
// => second target B

Try it