metalsmith-link-checker: retry EAI_AGAIN errors automatically (#243)

Author: emmercm

package-lock.json

@@ -1,5 +1,9 @@
 # Changelog
 
+## v2.1.17 / 2025-11-27
+
+- `EAI_AGAIN` errors are now retried automatically, regardless of of the `attempts` value.
+
 ## v2.1.1 / 2024-02-18
 
 - Don't validate `link[href][rel='preconnect']` links as they can 404 (e.g. `https://fonts.googleapis.com`).

packages/metalsmith-link-checker/CHANGELOG.md

@@ -128,7 +128,7 @@ const validUrl = async (
     return validUrlCache[link];
   }
 
-  const result = await new Promise<string | undefined>((resolve) => {
+  const errorMessage = await new Promise<string | undefined>((resolve) => {
     debug('checking URL with %s: %s, attempt %i', method, link, attempt);
     const library = link.slice(0, 5) === 'https' ? https : http;
     const req = library.request(
@@ -169,21 +169,29 @@ const validUrl = async (
   });
 
   // Re-attempt HEAD errors as GETs
-  if (result && method === 'HEAD') {
+  if (errorMessage && method === 'HEAD') {
     return validUrl(link, options, debug, attempt, 'GET');
   }
 
+  // Retry some failures automatically, even if retrying isn't specified
+  if (errorMessage?.indexOf('EAI_AGAIN') !== -1 && attempt <= (options.attempts ?? 0) + 3) {
+    await new Promise((resolve) => {
+      setTimeout(resolve, Math.min(1000, 100 * 2 ** attempt));
+    });
+    return validUrl(link, options, debug, attempt + 1, method);
+  }
+
   // Retry failures if we haven't reached the retry limit
-  if (result && attempt <= (options.attempts ?? 0)) {
+  if (errorMessage && attempt <= (options.attempts ?? 0)) {
     await new Promise((resolve) => {
       setTimeout(resolve, Math.min(1000, 100 * 2 ** attempt));
     });
     return validUrl(link, options, debug, attempt + 1, method);
   }
 
   // Otherwise, store the result and return
-  validUrlCache[link] = result;
-  return result;
+  validUrlCache[link] = errorMessage;
+  return errorMessage;
 };
 
 /**

packages/metalsmith-link-checker/index.ts

@@ -1,6 +1,6 @@
 {
   "name": "metalsmith-link-checker",
-  "version": "2.1.16",
+  "version": "2.1.17",
   "description": "A Metalsmith plugin to check for broken links.",
   "keywords": [
     "metalsmith",