萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 取得頁面 Meta Description 完整指南

前言

取得頁面 `` 內容常用於:社群分享預覽產生、SEO 分析工具、書籤小工具、內容擷取服務。本文提供原生 JS、jQuery、跨框架 (iframe) 等多種場景的完整取得方案。

核心原生 JS 實作 (現代標準)


function getMetaDescription(doc = document) {
    // 1. 標準 name="description"
    const meta = doc.querySelector('meta[name="description"]');
    if (meta && meta.getAttribute('content')) {
        return meta.getAttribute('content').trim();
    }

    // 2. 相容舊版:name 不分大小寫 (HTML 不區分大小寫)
    const metas = doc.getElementsByTagName('meta');
    for (let i = 0; i < metas.length; i++) {
        if (metas[i].getAttribute('name')?.toLowerCase() === 'description') {
            return metas[i].getAttribute('content')?.trim() || '';
        }
    }

    // 3. Open Graph 標籤 (社群分享常用)
    const ogDesc = doc.querySelector('meta[property="og:description"]');
    if (ogDesc) return ogDesc.getAttribute('content')?.trim() || '';

    // 4. Twitter Card
    const twitterDesc = doc.querySelector('meta[name="twitter:description"]');
    if (twitterDesc) return twitterDesc.getAttribute('content')?.trim() || '';

    return ''; // 找不到
}

jQuery 版本 (舊專案相容)


function getMetaDescriptionJQ() {
    // 方法一:屬性選擇器 (區分大小寫)
    let desc = $('meta[name="description"]').attr('content');
    
    // 方法二:不區分大小寫過濾
    if (!desc) {
        desc = $('meta[name]').filter(function() {
            return this.getAttribute('name').toLowerCase() === 'description';
        }).attr('content');
    }
    
    // 方法三:原文寫法 (不推薦,for...in 遍歷陣列有陷阱)
    /*
    var meta = document.getElementsByTagName('meta');
    for (var i in meta) { // ❌ 會遍歷 length、item 等屬性
        if (meta[i].name && meta[i].name.toLowerCase() === 'description') {
            return meta[i].content;
        }
    }
    */
    
    return desc?.trim() || '';
}

跨框架/iframe 取得 (同源限制)


// 同源 iframe
function getIframeMetaDescription(iframeId) {
    const iframe = document.getElementById(iframeId);
    try {
        const iframeDoc = iframe.contentDocument || iframe.contentWindow.document;
        return getMetaDescription(iframeDoc);
    } catch (e) {
        console.warn('跨域 iframe 無法存取:', e);
        return null; // 跨域會拋出 SecurityError
    }
}

// 跨域 iframe:需目標頁面配合 postMessage
// 目標頁面需監聽 message 事件並回傳 description

單頁應用 (SPA) 動態更新 Description

Vue/React/Angular 路由切換時需動態更新:


// Vue 3 Composition API 範例
import { useHead } from '@vueuse/head'; // 或 @unhead/vue

export default {
    setup() {
        useHead({
            meta: [
                { name: 'description', content: '動態生成的頁面描述...' },
                { property: 'og:description', content: 'OG 分享描述...' }
            ]
        });
    }
};

// 原生 JS 通用更新函式
function updateMetaDescription(content) {
    let meta = document.querySelector('meta[name="description"]');
    if (!meta) {
        meta = document.createElement('meta');
        meta.name = 'description';
        document.head.appendChild(meta);
    }
    meta.setAttribute('content', content);
}

進階:批次掃描頁面所有 Meta 標籤


function getAllMetaTags(doc = document) {
    const metas = doc.querySelectorAll('meta');
    const result = {};
    
    metas.forEach(meta => {
        const name = meta.getAttribute('name') || meta.getAttribute('property');
        const content = meta.getAttribute('content');
        if (name && content) {
            // 同名可能多個 (如多個 og:image),存陣列
            if (!result[name]) result[name] = [];
            result[name].push(content.trim());
        }
    });
    
    return result;
}

// 使用
const allMeta = getAllMetaTags();
console.log(allMeta.description); // ["頁面描述1", "頁面描述2"]
console.log(allMeta['og:title']); // ["OG 標題"]

Node.js 端解析 (爬蟲/SSR/預渲染)


// 使用 cheerio (jQuery 風格)
const cheerio = require('cheerio');
const fetch = require('node-fetch');

async function fetchMetaDescription(url) {
    const res = await fetch(url);
    const html = await res.text();
    const $ = cheerio.load(html);
    
    return $('meta[name="description"]').attr('content') 
        || $('meta[property="og:description"]').attr('content')
        || '';
}

// 使用 JSDOM (完整 DOM 模擬)
const { JSDOM } = require('jsdom');
const dom = new JSDOM(html, { url }); // url 為基礎 URL 解析相對路徑
const description = dom.window.document.querySelector('meta[name="description"]')?.getAttribute('content');

常見問題與解決

問題原因解決
取得空字串/undefined 頁面無 description、或 SPA 尚未渲染、或選擇器錯誤 檢查網頁原始碼、確認 SPA 資料載入完成後再取、使用正確選擇器
取到舊值 (SPA 路由切換) Meta 標籤未隨路由更新 使用 Vue Meta / React Helmet / Next.js Head 等方案管理
跨域 iframe 取不到 同源策略封鎖 目標頁面配合 postMessage 回傳
中文亂碼 編碼不一致 確保頁面 ``、伺服器回應正確 Content-Type

SEO 最佳實踐建議

  • 每頁唯一、精準描述頁面核心內容
  • 長度控制在 **150-160 字元** (Google 搜尋結果顯示長度)
  • 包含核心關鍵字,但避免關鍵字堆砌
  • 同時設定 og:description、twitter:description 確保社群分享正確
  • 避免模板化重複描述 (大量頁面相同 description 會被視為低品質)

總結

取得 Meta Description 核心為 document.querySelector('meta[name="description"]')?.getAttribute('content')。現代開發優先使用原生 API,搭配 OG/Twitter 標籤回退。SPA 需配合框架頭部管理庫動態更新。跨域 iframe 需 postMessage 協作。Node.js 端可用 Cheerio/JSDOM 解析。良好的 Description 為 SEO 與社群分享關鍵。

copyright © 萬盛學電腦網 all rights reserved