/// <summary>
/// Add a resolved callback and a rejected callback.
/// The resolved callback chains a value promise (optionally converting to a different value type).
/// </summary>
public IFpromise <ConvertedT> Then <ConvertedT>(Func <IFpromise <ConvertedT> > onResolved, Action <Exception> onRejected)
{
// This version of the function must supply an onResolved.
// Otherwise there is now way to get the converted value to pass to the resulting promise.
// Argument.NotNull(() => onResolved);
var resultFpromise = new Fpromise <ConvertedT>();
resultFpromise.WithName(Name);
Action resolveHandler = () =>
{
onResolved()
.Then(
// Should not be necessary to specify the arg type on the next line, but Unity (mono) has an internal compiler error otherwise.
(ConvertedT chainedValue) => resultFpromise.Resolve(chainedValue),
ex => resultFpromise.Reject(ex)
);
};
Action <Exception> rejectHandler = ex =>
{
if (onRejected != null)
{
onRejected(ex);
}
resultFpromise.Reject(ex);
};
ActionHandlers(resultFpromise, resolveHandler, rejectHandler);
return(resultFpromise);
}
/// <summary>
/// Add a resolved callback and a rejected callback.
/// </summary>
public IFpromise Then(Action onResolved, Action <Exception> onRejected)
{
var resultFpromise = new Fpromise();
resultFpromise.WithName(Name);
Action resolveHandler = () =>
{
if (onResolved != null)
{
onResolved();
}
resultFpromise.Resolve();
};
Action <Exception> rejectHandler = ex =>
{
if (onRejected != null)
{
onRejected(ex);
}
resultFpromise.Reject(ex);
};
ActionHandlers(resultFpromise, resolveHandler, rejectHandler);
return(resultFpromise);
}
/// <summary>
/// Completes the promise.
/// onResolved is called on successful completion.
/// onRejected is called on error.
/// </summary>
public void Done(Action onResolved, Action <Exception> onRejected)
{
// Argument.NotNull(() => onResolved);
// Argument.NotNull(() => onRejected);
var resultFpromise = new Fpromise();
resultFpromise.WithName(Name);
ActionHandlers(resultFpromise, onResolved, onRejected);
}
/// <summary>
/// Complete the promise. Adds a defualt error handler.
/// </summary>
public void Done()
{
var resultFpromise = new Fpromise();
resultFpromise.WithName(Name);
ActionHandlers(resultFpromise,
() =>
{
},
ex => Fpromise.PropagateUnhandledException(this, ex)
);
}
/// <summary>
/// Completes the promise.
/// onResolved is called on successful completion.
/// Adds a default error handler.
/// </summary>
public void Done(Action onResolved)
{
// Argument.NotNull(() => onResolved);
var resultFpromise = new Fpromise();
resultFpromise.WithName(Name);
ActionHandlers(resultFpromise,
onResolved,
ex => Fpromise.PropagateUnhandledException(this, ex)
);
}
/// <summary>
/// Returns a promise that resolves when all of the promises in the enumerable argument have resolved.
/// Returns a promise of a collection of the resolved results.
/// </summary>
public static IFpromise <IEnumerable <FpromisedT> > All(IEnumerable <IFpromise <FpromisedT> > promises)
{
var promisesArray = promises.ToArray();
if (promisesArray.Length == 0)
{
return(Fpromise <IEnumerable <FpromisedT> > .Resolved(EnumerableExtensions.Empty <FpromisedT>()));
}
var remainingCount = promisesArray.Length;
var results = new FpromisedT[remainingCount];
var resultFpromise = new Fpromise <IEnumerable <FpromisedT> >();
resultFpromise.WithName("All");
promisesArray.Each((promise, index) =>
{
promise
.Catch(ex =>
{
if (resultFpromise.CurState == FpromiseState.Pending)
{
// If a promise errorred and the result promise is still pending, reject it.
resultFpromise.Reject(ex);
}
})
.Then(result =>
{
results[index] = result;
--remainingCount;
if (remainingCount <= 0)
{
// This will never happen if any of the promises errorred.
resultFpromise.Resolve(results);
}
})
.Done();
});
return(resultFpromise);
}
/// <summary>
/// Return a new promise with a different value.
/// May also change the type of the value.
/// </summary>
public IFpromise <ConvertedT> Transform <ConvertedT>(Func <FpromisedT, ConvertedT> transform)
{
// Argument.NotNull(() => transform);
var resultFpromise = new Fpromise <ConvertedT>();
resultFpromise.WithName(Name);
Action <FpromisedT> resolveHandler = v =>
{
resultFpromise.Resolve(transform(v));
};
Action <Exception> rejectHandler = ex =>
{
resultFpromise.Reject(ex);
};
ActionHandlers(resultFpromise, resolveHandler, rejectHandler);
return(resultFpromise);
}
/// <summary>
/// Returns a promise that resolves when the first of the promises in the enumerable argument have resolved.
/// Returns the value from the first promise that has resolved.
/// </summary>
public static IFpromise Race(IEnumerable <IFpromise> promises)
{
var promisesArray = promises.ToArray();
if (promisesArray.Length == 0)
{
throw new ApplicationException("At least 1 input promise must be provided for Race");
}
var resultFpromise = new Fpromise();
resultFpromise.WithName("Race");
promisesArray.Each((promise, index) =>
{
promise
.Catch(ex =>
{
if (resultFpromise.CurState == FpromiseState.Pending)
{
// If a promise errorred and the result promise is still pending, reject it.
resultFpromise.Reject(ex);
}
})
.Then(() =>
{
if (resultFpromise.CurState == FpromiseState.Pending)
{
resultFpromise.Resolve();
}
})
.Done();
});
return(resultFpromise);
}
/// <summary>
/// Handle errors for the promise.
/// </summary>
public IFpromise Catch(Action <Exception> onRejected)
{
// Argument.NotNull(() => onRejected);
var resultFpromise = new Fpromise();
resultFpromise.WithName(Name);
Action resolveHandler = () =>
{
resultFpromise.Resolve();
};
Action <Exception> rejectHandler = ex =>
{
onRejected(ex);
resultFpromise.Reject(ex);
};
ActionHandlers(resultFpromise, resolveHandler, rejectHandler);
return(resultFpromise);
}
/// <summary>
/// Add a resolved callback and a rejected callback.
/// The resolved callback chains a non-value promise.
/// </summary>
public IFpromise Then(Func <FpromisedT, IFpromise> onResolved, Action <Exception> onRejected)
{
var resultFpromise = new Fpromise();
resultFpromise.WithName(Name);
Action <FpromisedT> resolveHandler = v =>
{
if (onResolved != null)
{
onResolved(v)
.Then(
() => resultFpromise.Resolve(),
ex => resultFpromise.Reject(ex)
);
}
else
{
resultFpromise.Resolve();
}
};
Action <Exception> rejectHandler = ex =>
{
if (onRejected != null)
{
onRejected(ex);
}
resultFpromise.Reject(ex);
};
ActionHandlers(resultFpromise, resolveHandler, rejectHandler);
return(resultFpromise);
}
