`mightFail` Async

Wrap Promise

Simply wrap any promise in mightFail and await the result.

You will get and Either object that contains either an error or the result. Never both.

const eitherObject = await mightFail(fetch("/posts"));

const eitherObject = await mightFail(fetch("/posts"));

const eitherObject = await mightFail(fetch("/posts"));

const eitherObject = await mightFail(fetch("/posts"));

But don't store the Either object directly. Instead, destructure it in the same statement.

// tuple destructuring
const [ error, result ] = await mightFail(fetch("/posts"));

// object destructuring
const { error, result } = await mightFail(fetch("/posts"));

// go destructuring
// import { mightFail } from "might-fail/go";
const [ result, error ] = await mightFail(fetch("/posts"));

// tuple destructuring
const [ error, result ] = await mightFail(fetch("/posts"));

// object destructuring
const { error, result } = await mightFail(fetch("/posts"));

// go destructuring
// import { mightFail } from "might-fail/go";
const [ result, error ] = await mightFail(fetch("/posts"));

// tuple destructuring
const [ error, result ] = await mightFail(fetch("/posts"));

// object destructuring
const { error, result } = await mightFail(fetch("/posts"));

// go destructuring
// import { mightFail } from "might-fail/go";
const [ result, error ] = await mightFail(fetch("/posts"));

// tuple destructuring
const [ error, result ] = await mightFail(fetch("/posts"));

// object destructuring
const { error, result } = await mightFail(fetch("/posts"));

// go destructuring
// import { mightFail } from "might-fail/go";
const [ result, error ] = await mightFail(fetch("/posts"));

You can choose to destructure this object as a tuple or as an object. Or as a backwards tuple if you prefer it that way.

We think that the tuple option is the best, but you do you.

Guard

Once you've awaited and destructured the Either object, use guard clauses to handle the error, and handle the success case at the end.

const [ networkError, result ] = await mightFail(fetch("/posts"));

if (networkError) {
  // handle network error
  return;
}

if (!result.ok) {
  // handle an error response from server
  return;
}

const [convertToJSONError, posts] = await mightFail(
  result.json()
);

if (convertToJSONError) {
  // handle convertToJSONError
  return;
}

posts.map((post) => console.log(post.title));

const [ networkError, result ] = await mightFail(fetch("/posts"));

if (networkError) {
  // handle network error
  return;
}

if (!result.ok) {
  // handle an error response from server
  return;
}

const [convertToJSONError, posts] = await mightFail(
  result.json()
);

if (convertToJSONError) {
  // handle convertToJSONError
  return;
}

posts.map((post) => console.log(post.title));

const [ networkError, result ] = await mightFail(fetch("/posts"));

if (networkError) {
  // handle network error
  return;
}

if (!result.ok) {
  // handle an error response from server
  return;
}

const [convertToJSONError, posts] = await mightFail(
  result.json()
);

if (convertToJSONError) {
  // handle convertToJSONError
  return;
}

posts.map((post) => console.log(post.title));

const [ networkError, result ] = await mightFail(fetch("/posts"));

if (networkError) {
  // handle network error
  return;
}

if (!result.ok) {
  // handle an error response from server
  return;
}

const [convertToJSONError, posts] = await mightFail(
  result.json()
);

if (convertToJSONError) {
  // handle convertToJSONError
  return;
}

posts.map((post) => console.log(post.title));

mightFail Async

Wrap Promise

Guard

`mightFail` Async