Sample Error Event Handling Documentation Does Not Work

[mnalsup]

In the docs here: https://node-postgres.com/features/pooling#checkout-use-and-return

  pool.on('error', (err, client) => {
    console.error('Unexpected error on idle client', err)
    process.exit(-1)
  }

The above sample code snippet did not seem to catch an error from an AWS RDS failover. I received this error when using sample code:

node:events:495
      throw er; // Unhandled 'error' event
      ^

Error: Connection terminated unexpectedly
    at Connection.<anonymous> (/Users/malsup/Development/gitlab.workfront.tech/alloy/fusion-pg/node_modules/pg/lib/client.js:132:73)

However when I added an error event handler to the client in the response from the connect() call as below I was able to catch the error.

const { Pool } = require('pg')

const start = async () => {

  const pool = new Pool({
    user: 'postgres',
    password: 'postgres',
    host: 'localhost',
    port: 5432,
  })

  // the pool will emit an error on behalf of any idle clients
  // it contains if a backend error or network partition happens
  pool.on('error', (err, client) => {
    console.error('Unexpected error on idle client', err)
    process.exit(-1)
  })

  const client = await pool.connect()
  // Added snippet for client errors
  client.on('error', (err, client) => {
    console.error('Unexpected error on idle client', err)
    process.exit(-1)
  })
  for (let i = 0; i < 500; i++) {
    const res = await client.query('SELECT 1')
    console.log(res.rows)
    await new Promise((resolve) => setTimeout(resolve, 500))
  }

  client.release()
}
start()

Unexpected error on idle client Error: Connection terminated unexpectedly
    at Connection.<anonymous> (/Users/malsup/Development/gitlab.workfront.tech/alloy/fusion-pg/node_modules/pg/lib/client.js:132:73)

Is this a documentation issue or should the pool be "forwarding" this error event up from the client?