.README/USAGE.md

@@ -29,6 +29,13 @@ postgresql://foo:bar@localhost
 postgresql://foo@localhost/bar?application_name=baz
 ```
 
+Unix-domain socket connection is chosen if the host part is either empty or looks like an absolute path name.
+
+```text
+postgresql:///dbname?host=/var/lib/postgresql
+postgresql://%2Fvar%2Flib%2Fpostgresql/dbname
+```
+
 Other configurations are available through the [`clientConfiguration` parameter](https://github.com/gajus/slonik#api).
 
 ### Create connection

README.md

@@ -453,6 +453,13 @@ postgresql://foo:bar@localhost
 postgresql://foo@localhost/bar?application_name=baz
 ```
 
+Unix-domain socket connection is chosen if the host part is either empty or looks like an absolute path name.
+
+```text
+postgresql:///dbname?host=/var/lib/postgresql
+postgresql://%2Fvar%2Flib%2Fpostgresql/dbname
+```
+
 Other configurations are available through the [`clientConfiguration` parameter](https://github.com/gajus/slonik#api).
 
 <a name="user-content-slonik-usage-create-connection"></a>

benchmark/clients/postgres.js

@@ -3,7 +3,7 @@ const postgres = require('postgres');
 const sql = postgres('postgres://postgres@127.0.0.1:5432', {
   // Unlike "pg", "pg-promise" and "slonik", "postgres" does provide a method to explicitly create a connection.
   // https://github.com/porsager/postgres/tree/v3.0.0#the-connection-pool
-  // `max: 1` mimics this behaviour as close as possible.
+  // `max: 1` mimics this behavior as close as possible.
   max: 1,
 });
 

cspell.yml

@@ -0,0 +1,17 @@
+allowCompoundWords: true
+dictionaries:
+  - sql
+  - typescript
+ignorePaths:
+  - node_modules
+  - dist
+  - README.md
+language: en
+minWordLength: 5
+version: '0.2'
+words:
+  - slonik
+  - gajus
+  - kuizinas
+  - roarr
+  - plpgsql

package.json

@@ -27,6 +27,7 @@
     "@types/sinon": "^10.0.15",
     "@types/through2": "^2.0.38",
     "ava": "^5.3.0",
+    "cspell": "^7.3.6",
     "delay": "^5.0.0",
     "eslint": "^8.41.0",
     "eslint-config-canonical": "^41.0.5",
@@ -89,10 +90,11 @@
   "scripts": {
     "build": "rm -fr ./dist && tsc --project ./tsconfig.build.json",
     "create-readme": "gitdown ./.README/README.md --output-file ./README.md",
+    "lint:cspell": "cspell . --no-progress --gitignore",
     "lint:eslint": "eslint --cache ./src ./test",
     "lint:knip": "knip",
     "lint:tsc": "tsc --noEmit",
-    "lint": "npm run lint:eslint && npm run lint:knip && npm run lint:tsc",
+    "lint": "npm run lint:cspell && npm run lint:eslint && npm run lint:knip && npm run lint:tsc",
     "test": "nyc ava --verbose --serial"
   },
   "types": "./dist/index.d.ts",

src/utilities/parseDsn.ts

@@ -17,6 +17,12 @@ export const parseDsn = (dsn: string): ConnectionOptions => {
 
   if (url.host) {
     connectionOptions.host = decodeURIComponent(url.hostname);
+  } else if (url.searchParams.has('host')) {
+    const host = url.searchParams.get('host');
+
+    if (typeof host === 'string' && host) {
+      connectionOptions.host = host;
+    }
   }
 
   if (url.port) {

test/helpers/createIntegrationTests.ts

@@ -660,6 +660,7 @@ export const createIntegrationTests = (
       PgPool,
     });
 
+    // cspell:disable-next-line
     const payload = 'foobarbazqux';
 
     await pool.query(sql.unsafe`

test/slonik/utilities/parseDsn.ts

@@ -38,12 +38,27 @@ test('postgresql://fo%2Fo:b%2Far@localhost/ba%2Fz', testParse, {
   username: 'fo/o',
 });
 test(
-  'postgresql://db_user:db_password@%2Fcloudsql%2Fproject-id%3Aregion-id1%3Acloudsqlinstance-name/dbname',
+  // cspell: disable-next-line
+  'postgresql://db_user:db_password@%2Fcloudsql%2Fproject-id%3Aregion-id1%3Acloudsqlinstance-name/database-name',
   testParse,
   {
-    databaseName: 'dbname',
+    databaseName: 'database-name',
     host: '/cloudsql/project-id:region-id1:cloudsqlinstance-name',
     password: 'db_password',
     username: 'db_user',
   },
 );
+
+// https://github.com/gajus/slonik/issues/468#issuecomment-1736020990
+// cspell: disable-next-line
+test('postgresql://%2Fvar%2Flib%2Fpostgresql/database-name', testParse, {
+  databaseName: 'database-name',
+  host: '/var/lib/postgresql',
+});
+
+// https://github.com/gajus/slonik/issues/468#issuecomment-1736020990
+// cspell: disable-next-line
+test('postgresql:///database-name?host=/var/lib/postgresql', testParse, {
+  databaseName: 'database-name',
+  host: '/var/lib/postgresql',
+});