redux-async-kit
v0.0.21
Published
A simplify work flow for redux
Downloads
115
Maintainers
Readme
redux - async - kit
This is a scoped redux reducer kit
Usage
You can run project by npm start
to start storybook.
Slice
import { createSlice } from 'redux-async-kit'
// you can create simple like this
const testSlice = createSlice('test', {
testReducer,
})
// and create the data in reducer
/*
{
test: {
testReducer: {
__values__: {
scope: ['test'],
},
}
}
}
*/
Reducer
import { createReducer } from 'redux-async-kit'
// you must create reducer by createReducer
const initialState = {
name: 'testName',
}
const TEST_ACTION = 'TEST_ACTION'
const TEST_ACTION_IMMER = 'TEST_ACTION_IMMER'
// reducer is only change to reducer map, and you can use immer in reducer map
const reducerMap = (state: any) => ({
[TEST_ACTION]: () => {
return {
name: 'testAction',
}
},
[TEST_ACTION_IMMER]: (action) => {
// usage by immer
state.name = action.payload
},
})
export const testReducer = createReducer(initialState, reducerMap)
Selector
// selector is a method for get value by root state
export const testSelector = {
testName: (state: any) => state.testReducer.name,
testDetail: (state: any) => state.testReducer.detail,
}
Action
import { TEST_ACTION, TEST_ASYNC_ACTION } from './enums'
import { createPayloadAction } from '../modules/creator'
import { testSlice } from '.'
import { testSelector } from './selectors'
import { memoryCache } from '../modules/cache'
const sleep = (timeountMS: any) =>
new Promise((resolve) => {
setTimeout(resolve, timeountMS)
})
const getName = async ({ count, keyword }: any = {}) => {
await sleep(1000)
if (keyword === '1') {
throw new Error('keyword === 1')
}
return 'GetNameSuccess' + count
}
const getDetail = async ({ name }: any = {}) => {
await sleep(500)
return 'GetDetailSuccess:' + name
}
export const testAction = {
setName: createPayloadAction(TEST_ACTION.SET_NAME),
setDetail: createPayloadAction(TEST_ACTION.SET_DETAIL),
}
// type: action type
// - string
// selector: select data from root state
// - state => ({ ... })
// - { [name]: [slice.selector(state => ...)] }
// meta: target params
// - { ... }
// - selector => ({ ... })
// target: promise function
// - async () => { ... }
// success/failure: success dispatch
// - string: action type
// - (data) => { type: XXX, data }
// cache: provice cache method
// - ({ meta, selector }) => {
// return value || cacheValue()
// }
//
export const testAsyncAction = {
getName: (count: any, keyword: any) => ({
type: TEST_ASYNC_ACTION.GET_NAME,
meta: { count, keyword },
target: getName,
success: testAction.setName,
failure: TEST_ACTION.SET_ERROR,
}),
getDetail: () => ({
type: TEST_ASYNC_ACTION.GET_DETAIL,
target: getDetail,
selector: {
name: testSlice.selector(testSelector.testName),
},
meta: ({ name }: any) => ({ name }),
failure: TEST_ACTION.SET_ERROR,
success: testAction.setDetail,
}),
getDetailByCache: (keyword: any) => ({
type: TEST_ASYNC_ACTION.GET_DETAIL,
target: getDetail,
selector: {
name: testSlice.selector(testSelector.testName),
},
meta: ({ name }: any) => ({ name }),
cache: ({ meta }: any) => memoryCache(meta),
failure: TEST_ACTION.SET_ERROR,
success: testAction.setDetail,
}),
}
Store
import { configureStore createLazyComponent } from 'redux-async-kit'
const store = configureStore({
injector: testSlice.injector,
})
// inject by dynamic
const HomePage = createLazyComponent({
injector: homeSlice.injector,
loader: () => import('./TestPage' /* webpackChunkName: "home" */),
})
Hooks
const TestComponent = () => {
const [count, setCount] = React.useState(0)
const [name, cacheName] = testSlice.useSelector(testSelector.testName)
const [detail] = testSlice.useSelector(testSelector.testDetail)
const [setName] = testSlice.useAction(testAction.setName)
const [getName, nameState] = testSlice.useAction(testAsyncAction.getName)
const [getDetail, detailState] = testSlice.useAction(testAsyncAction.getDetail)
const [getDetailByCache, detailCacheState] = testSlice.useAction(testAsyncAction.getDetailByCache)
const onSetName = () => {
setName('ON SET NAME')
}
const onGetName = useAsyncCallback(async (e: any) => {
await getName(count)
await getDetail()
}, [count])
const onGetNameByKeyword = useAsyncCallback((keyword: any) => async (e: any) => {
await getName(count, keyword)
await getDetail()
}, [count])
const onGetDetailByCache = useAsyncCallback(async (e: any) => {
await getDetailByCache()
}, [count])
const onGetDetail = useAsyncCallback(async (e: any) => {
await getDetail()
}, [count])
useAsyncEffect(async () => {
await getName(count)
await getDetailByCache()
})
return (
<div> ... </div>
)
}
Thanks