あとで読むURLのリンク切れを開く前に発見｜GASで応答状態をdry-run監査

const LINK_AUDIT_CONFIG = Object.freeze({
  sheetName: 'Watchlist',
  maxRows: 20,
  dryRun: true,
  allowedSchemes: ['http:', 'https:']
});

function auditWatchlistLinksFree() {
  const config = LINK_AUDIT_CONFIG;
  validateLinkAuditConfig_(config);

  if (config.dryRun !== true) {
    throw new Error('安全のためdryRun=trueで実行してください。');
  }

  const sheet = SpreadsheetApp.getActiveSpreadsheet()
    .getSheetByName(config.sheetName);
  if (!sheet) {
    throw new Error('Watchlistシートが見つかりません。');
  }

  const lastRow = sheet.getLastRow();
  if (lastRow < 2) {
    console.log('対象0件です。');
    return;
  }

  const rowCount = Math.min(lastRow - 1, config.maxRows);
  const rows = sheet.getRange(2, 1, rowCount, 4).getDisplayValues();
  const seenIds = new Set();
  const results = [];

  rows.forEach((row, index) => {
    const sheetRow = index + 2;
    const id = String(row[0] || '').trim();
    const rawUrl = String(row[2] || '').trim();

    const inputError = validateWatchlistRow_(id, rawUrl, seenIds);
    if (inputError) {
      results.push({ sheetRow, result: 'INPUT_HOLD', status: null });
      console.log(`行${sheetRow}: INPUT_HOLD / ${inputError}`);
      return;
    }
    seenIds.add(id);

    try {
      const response = UrlFetchApp.fetch(rawUrl, {
        method: 'get',
        headers: { Range: 'bytes=0-0' },
        followRedirects: false,
        muteHttpExceptions: true,
        validateHttpsCertificates: true
      });
      const status = response.getResponseCode();
      const result = classifyHttpStatus_(status);
      results.push({ sheetRow, result, status });
      console.log(`行${sheetRow}: ${result} / HTTP ${status}`);
    } catch (error) {
      results.push({ sheetRow, result: 'REQUEST_ERROR', status: null });
      console.log(`行${sheetRow}: REQUEST_ERROR / 詳細は非表示`);
    }
  });

  const summary = results.reduce((count, item) => {
    count[item.result] = (count[item.result] || 0) + 1;
    return count;
  }, {});
  console.log(`監査完了: ${JSON.stringify(summary)}`);
  console.log('URL・ページ本文・認証情報はログへ出していません。');
}

function validateLinkAuditConfig_(config) {
  if (config.dryRun !== true) {
    throw new Error('dryRunはtrue固定です。');
  }
  if (!Number.isInteger(config.maxRows) || config.maxRows < 1 || config.maxRows > 20) {
    throw new Error('maxRowsは1〜20の整数にしてください。');
  }
}

function validateWatchlistRow_(id, rawUrl, seenIds) {
  if (!id) return 'IDが空欄です';
  if (seenIds.has(id)) return 'IDが重複しています';
  if (!rawUrl) return 'URLが空欄です';

  let parsed;
  try {
    parsed = new URL(rawUrl);
  } catch (error) {
    return 'URL形式が不正です';
  }

  if (!LINK_AUDIT_CONFIG.allowedSchemes.includes(parsed.protocol)) {
    return 'http/https以外は対象外です';
  }
  if (parsed.username || parsed.password) {
    return '認証情報を含むURLは対象外です';
  }
  if (isPrivateHost_(parsed.hostname)) {
    return 'ローカル・プライベート宛先は対象外です';
  }
  return '';
}

function isPrivateHost_(hostname) {
  const host = String(hostname || '').toLowerCase();
  if (host === 'localhost' || host.endsWith('.local')) return true;
  if (/^127\./.test(host) || /^10\./.test(host) || /^192\.168\./.test(host)) return true;
  if (/^169\.254\./.test(host)) return true;
  const match172 = host.match(/^172\.(\d{1,3})\./);
  return Boolean(match172 && Number(match172[1]) >= 16 && Number(match172[1]) <= 31);
}

function classifyHttpStatus_(status) {
  if (status >= 200 && status < 300) return 'OK';
  if (status >= 300 && status < 400) return 'REDIRECT';
  if (status === 401 || status === 403) return 'AUTH_OR_BLOCKED';
  if (status === 404 || status === 410) return 'MISSING';
  if (status === 405) return 'METHOD_BLOCKED';
  if (status === 429) return 'RATE_LIMITED';
  if (status >= 500) return 'SERVER_ERROR';
  return 'CHECK_REQUIRED';
}