取得頁面 `` 內容常用於:社群分享預覽產生、SEO 分析工具、書籤小工具、內容擷取服務。本文提供原生 JS、jQuery、跨框架 (iframe) 等多種場景的完整取得方案。
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 ''; // 找不到
}
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
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
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);
}
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 標題"]
// 使用 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 |
og:description、twitter:description 確保社群分享正確取得 Meta Description 核心為 document.querySelector('meta[name="description"]')?.getAttribute('content')。現代開發優先使用原生 API,搭配 OG/Twitter 標籤回退。SPA 需配合框架頭部管理庫動態更新。跨域 iframe 需 postMessage 協作。Node.js 端可用 Cheerio/JSDOM 解析。良好的 Description 為 SEO 與社群分享關鍵。