About handling failure

Hi guys,

In the following saga, I deliberately returned an error

/**
 * Authentication saga
 */
export function *loginFlow () {
  while (true) {
    let request = yield take(LOGIN_REQUEST);
    let error = 'Invalid username or password';
    yield put(loginFailure(error));
  }
}

And my redux-form:

const { handleSubmit, error, submitting } = this.props;
const onSubmit = handleSubmit(actions.formAction);
return (
  <div>
    <form className="ui large form" onSubmit={onSubmit}>
    // ...
    </form>
    { error &&
      (
        <div className="ui error message">
          <span>Login failed</span>
        </div>
      )
    }      
  </div>
)

I expected to see the error message of Login failed when the form’s submitted. But what I’ve got is a Promise rejection:

Would you please tell me how to handle rejections properly?

[afitiskin]

@dandonahoe proper usage is following:

1. Create action: const submitForm = createFormAction('SUBMIT_FORM')
2. Pass it to handleSubmit function of your form: <form onSubmit={handleSubmit(submitForm)}>
3. Take submitForm.REQUEST action in your saga and handle it:

function* formSubmitWatcherSaga() {
  yield takeEvery(submitForm.REQUEST, handleFormSubmitSaga);
}

function* handleFormSubmitSaga(action) {
  const values = action.payload; // values of your form, you can validate it on client side
  // or send it directly to the server
  // it's up to you what you do

  if (successful) {
    yield put(submitForm.success()); // dispatch success action
    // it will automatically resolves the promise given to redux-form
    // so redux form will finish submit with successful result
  } else {
    const error = new SubmissionError({
      field1: 'This field is required', // mark specific field as it has error
      _error: 'Failed! Please fill the form correctly and try again', // set global form error
    });
    yield put(submitForm.failure(error)); // dispatch failure action
    // pass error (instance of SubmissionError) to it
    // promise given to redux-form will be rejected with the error
    // so all wrong fields will be marked and form will get global error 
  }
}

[afitiskin]

Updated README as well