Skip to main content

timedOut

Note

This is a point-in-time snapshot of the API documentation from January 2026. Going forward, we will not be maintaining a public copy of these references, and recommend users to refer to the built-in signature helpers available in the Hack LSP instead for complete and up-to-date information.

Returns whether the type of failure that produced the exception was a timeout

public function timedOut(): bool;

An AsyncMysqlErrorResult can occur due to 'TimedOut', representing a timeout, or 'Failed', representing the server rejecting the connection or query.

Returns

  • bool - true if the type of failure was a time out; false otherwise.

Examples

The following example shows how to use AsyncMysqlException::timedOut to determine if the connection failed by a timeout.

use \Hack\UserDocumentation\API\Examples\AsyncMysql\ConnectionInfo as CI;

async function connect(
\AsyncMysqlConnectionPool $pool,
): Awaitable<\AsyncMysqlConnection> {
return await $pool->connect(
CI::$host,
CI::$port,
CI::$db,
CI::$user,
"thisIsNotThePassword",
);
}
async function simple_query(): Awaitable<?string> {
$pool = new \AsyncMysqlConnectionPool(darray[]);
$conn = null;
$ret = null;
try {
$conn = await connect($pool);
$result = await $conn->query(
'SELECT name FROM test_table WHERE userID = 1',
);
$conn->close();
return $result->vectorRows()[0][0];
} catch (\AsyncMysqlConnectException $ex) { // implicitly constructed
$ret = "Connection Exception";
\var_dump($ex->timedOut());
} catch (\AsyncMysqlQueryException $ex) { // implicitly constructed
$ret = "Query Exception";
} catch (\AsyncMysqlException $ex) {
$ret = null;
} finally {
if ($conn) {
$conn->close();
}
}
return $ret;
}

<<__EntryPoint>>
async function run(): Awaitable<void> {
$r = await simple_query();
\var_dump($r);
}
```.hhvm.expectf
bool(false)
string(20) "Connection Exception"
```.example.hhvm.out
bool(false)
string(20) "Connection Exception"
```.skipif
await \Hack\UserDocumentation\API\Examples\AsyncMysql\skipif_async();