Interface GuzzleHttp\Promise\PromiseInterface


					
	public

then<TFulfilledValue = never, TFulfilledReason = never, TRejectedValue = never, TRejectedReason = never>(
	(callable(TValue): (TFulfilledValue|PromiseInterface<TFulfilledValue, TFulfilledReason>))|null $onFulfilled = null,
	(callable(TReason): (TRejectedValue|PromiseInterface<TRejectedValue, TRejectedReason>))|null $onRejected = null,
): PromiseInterface<($onFulfilled is null ? TValue : TFulfilledValue)|($onRejected is null ? never : TRejectedValue), ($onFulfilled is null ? never : TFulfilledReason|Throwable)|($onRejected is null ? TReason : TRejectedReason|Throwable)>

Appends fulfillment and rejection handlers to the promise, and returns a new promise resolving to the return value of…

Appends fulfillment and rejection handlers to the promise, and returns a new promise resolving to the return value of the called handler.

Parameters

`$onFulfilled`	Invoked when the promise fulfills.
`$onRejected`	Invoked when the promise is rejected.

#


					
	public

otherwise<TRejectedValue = never, TRejectedReason = never>(
	callable(TReason): (TRejectedValue|PromiseInterface<TRejectedValue, TRejectedReason>) $onRejected,
): PromiseInterface<TValue|TRejectedValue, TRejectedReason|Throwable>

Appends a rejection handler callback to the promise, and returns a new promise resolving to the return value of the…

Appends a rejection handler callback to the promise, and returns a new promise resolving to the return value of the callback if it is called, or to its original fulfillment value if the promise is instead fulfilled.

Parameters

$onRejected

Invoked when the promise is rejected.

#


					
	public

getState(): self::PENDING|self::FULFILLED|self::REJECTED

Get the state of the promise ("pending", "rejected", or "fulfilled").

The three states can be checked against the constants defined on PromiseInterface: PENDING, FULFILLED, and REJECTED.

The state describes how this promise was settled, not the eventual outcome: a promise that was resolved with another promise, directly or by returning one from a then() handler, reports FULFILLED while the inner promise may still be pending, and wait() can still throw if the inner promise rejects. Poll the state only on promises settled with plain values, or call wait() first.

#


					
	public

resolve(TValue|PromiseInterface<TValue, TReason>|null $value = null): void

Resolve the promise with the given value, or with null if no value is given.

Throws

LogicException

if the promise is already settled with a conflicting resolution.

#


					
	public

reject(TReason $reason): void

Reject the promise with the given reason.

Throws

LogicException

if the promise is already settled with a conflicting resolution.

#


					
	public

cancel(): void

Cancels the promise if possible.

#


					
	public

wait(bool $unwrap = true): ($unwrap is true ? TValue : null)

Waits until the promise completes if possible.

Pass $unwrap as true to unwrap the result of the promise, either returning the resolved value or throwing the rejected exception.

If the promise cannot be waited on, then the promise will be rejected.

Throws

LogicException

if the promise has no wait function or if the promise does not settle after waiting.

#

Constants
`public`	`PENDING = 'pending'`	#
`public`	`FULFILLED = 'fulfilled'`	#
`public`	`REJECTED = 'rejected'`	#

Namespaces

Interfaces

Interface GuzzleHttp\Promise\PromiseInterface

`<TValue = mixed, TReason = mixed>`

Parameters

Parameters

Throws

Throws

Throws