JavaScript
Node.js
Fonksiyonlar
Algoritmalar
Lisans: GPL
JavaScript (Node.js) — ensureDir İşlevi (build.js)
Orijinal Kod Adı:
JavaScript (Node.js) — build.js
Bu JavaScript (Node.js) kodu (`build.js`), modüler iş mantığını ve yardımcı rutinleri uygular. Dosya ölçeği: 59 satır (~1.6 KB). Sağladığı başlıca fonksiyonlar: `ensureDir`, `copyWhitelist`, `build` (oluşturma), `zipFolder`. Kullandığı modül/paketler: fs, path, archiver. Kaynak depo: kazcfz/Copy-n-Paste.
💡 Püf Noktaları:
• Kullanıcı veya API metinlerini DOM'a eklerken `innerHTML` yerine `textContent` kullanarak istemci taraflı XSS açıklarını engelleyin.
• Klavye girişi veya kaydırma gibi sık tetiklenen olaylarda `debounce` ekleyerek gereksiz ağ isteklerini azaltın.
• `build.js` dosyasındaki ortam bağımlı sabitleri (DSN, anahtar, URL) doğrudan kod yerine `.env` veya merkezi ayar katmanından okuyun.
• JavaScript kodunu canlı ortama taşımadan önce kenar durumları (boş girdi, zaman aşımı, hatalı format) için test senaryosu oluşturun.
🛠️ Uygulama Tarifi:
1. Dosyayı proje `src/` veya `assets/js/` dizinine ekleyip gerekli ise tip/paket bağımlılıklarını (`npm install`) kurun.
2. Modülü `import { ensureDir } from './build.js';` şeklinde içe aktarın ve DOM hazır olduktan sonra tetikleyin.
3. Tarayıcı Geliştirici Araçları > Console ve Network sekmelerinden DOM güncellemeleri ile API yanıtlarını doğrulayın.
💡 Püf Noktaları:
• Kullanıcı veya API metinlerini DOM'a eklerken `innerHTML` yerine `textContent` kullanarak istemci taraflı XSS açıklarını engelleyin.
• Klavye girişi veya kaydırma gibi sık tetiklenen olaylarda `debounce` ekleyerek gereksiz ağ isteklerini azaltın.
• `build.js` dosyasındaki ortam bağımlı sabitleri (DSN, anahtar, URL) doğrudan kod yerine `.env` veya merkezi ayar katmanından okuyun.
• JavaScript kodunu canlı ortama taşımadan önce kenar durumları (boş girdi, zaman aşımı, hatalı format) için test senaryosu oluşturun.
🛠️ Uygulama Tarifi:
1. Dosyayı proje `src/` veya `assets/js/` dizinine ekleyip gerekli ise tip/paket bağımlılıklarını (`npm install`) kurun.
2. Modülü `import { ensureDir } from './build.js';` şeklinde içe aktarın ve DOM hazır olduktan sonra tetikleyin.
3. Tarayıcı Geliştirici Araçları > Console ve Network sekmelerinden DOM güncellemeleri ile API yanıtlarını doğrulayın.
Dikkat Edilmesi Gerekenler:
• [Hata Yönetimi] Üretime almadan önce geçersiz girdi, eksik ortam değişkeni ve bağlantı kesilmesi senaryoları için istisna/hata loglamasını doğrulayın.
• [Sürüm & Test] Bağımlılık ve çalışma ortamı sürümlerini (PHP/Node/Python/DB) hedef sunucuyla eşleştirip test ortamında doğruladıktan sonra dağıtın.
• [Hata Yönetimi] Üretime almadan önce geçersiz girdi, eksik ortam değişkeni ve bağlantı kesilmesi senaryoları için istisna/hata loglamasını doğrulayın.
• [Sürüm & Test] Bağımlılık ve çalışma ortamı sürümlerini (PHP/Node/Python/DB) hedef sunucuyla eşleştirip test ortamında doğruladıktan sonra dağıtın.
const fs = require('fs');
const path = require('path');
const archiver = require('archiver');
// List exactly what to include
const includeFolders = ['icons', 'media'];
const includeFiles = ['background.js', 'content.js', 'init.js', 'overlay.html'];
function ensureDir(dir) {
if (!fs.existsSync(dir)) {
fs.mkdirSync(dir, { recursive: true });
}
}
function copyWhitelist(outDir) {
// Copy specific folders
includeFolders.forEach(folder => {
if (fs.existsSync(folder)) {
fs.cpSync(folder, path.join(outDir, folder), { recursive: true });
}
});
// Copy specific files
includeFiles.forEach(file => {
if (fs.existsSync(file)) {
fs.copyFileSync(file, path.join(outDir, file));
}
});
}
function build(target) {
const outDir = path.join('dist', target);
fs.rmSync(outDir, { recursive: true, force: true });
ensureDir(outDir);
// Copy whitelisted files/folders
copyWhitelist(outDir);
// Copy platform-specific manifest.json
fs.copyFileSync(`platform/${target}/manifest.json`, path.join(outDir, 'manifest.json'));
return outDir;
}
async function zipFolder(folder, outFile) {
const output = fs.createWriteStream(outFile);
const archive = archiver('zip');
archive.pipe(output);
archive.directory(folder, false);
await archive.finalize();
}
(async () => {
const chromiumDir = build('chromium');
const firefoxDir = build('firefox');
ensureDir('dist/zips');
await zipFolder(chromiumDir, 'dist/zips/extension-chromium.zip');
await zipFolder(firefoxDir, 'dist/zips/extension-firefox.zip');
})();