mirror of
https://github.com/MasterAcnolo/Freedom-Loader.git
synced 2026-07-29 18:25:47 +02:00
refactor: add full documentation and fix theme loading robustness
- Add JSDoc comments across frontend and backend modules - Improve code readability and maintainability with consistent documentation style - Document Electron IPC handlers, UI utilities, and theme system - Add missing function/class documentation in theme loader and app services - Minor structural improvements and cleanup across Electron main process modules - Minor fixes on variable names
This commit is contained in:
@@ -1,12 +1,33 @@
|
||||
/**
|
||||
* Converts a raw upload date string (format YYYYMMDD)
|
||||
* into a human-readable format (DD/MM/YYYY).
|
||||
*
|
||||
* Returns "Inconnue" if the input is invalid or malformed.
|
||||
*/
|
||||
function formatDate(dateStr) {
|
||||
if (!dateStr || dateStr.length !== 8) return "Inconnue";
|
||||
return `${dateStr.slice(6,8)}/${dateStr.slice(4,6)}/${dateStr.slice(0,4)}`;
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts a file size in bytes into megabytes (MB).
|
||||
*
|
||||
* Returns a formatted string with 2 decimals (e.g. "12.34 Mo").
|
||||
* If input is falsy, returns "Inconnue".
|
||||
*/
|
||||
function formatSize(bytes) {
|
||||
return bytes ? (bytes / (1024*1024)).toFixed(2) + " Mo" : "Inconnue";
|
||||
}
|
||||
|
||||
/**
|
||||
* Fetches video or playlist metadata from the backend `/info` endpoint.
|
||||
*
|
||||
* Sends a POST request with URL-encoded body.
|
||||
* Handles network errors, HTTP errors and JSON parsing safely.
|
||||
*
|
||||
* @param {string} url - Video or playlist URL
|
||||
* @returns {Promise<Object>} Parsed metadata or error object
|
||||
*/
|
||||
async function fetchVideoInfo(url) {
|
||||
try {
|
||||
const res = await fetch("/info", {
|
||||
@@ -26,9 +47,19 @@ async function fetchVideoInfo(url) {
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Initializes the video info system UI.
|
||||
*
|
||||
* - Listens to URL input changes
|
||||
* - Automatically fetches video/playlist metadata if enabled
|
||||
* - Renders either playlist UI or single video UI
|
||||
* - Handles loading states and caching (lastFetchedUrl)
|
||||
*
|
||||
* Also manages dynamic playlist title injection into the form.
|
||||
*/
|
||||
async function init() {
|
||||
|
||||
// Main input listener: triggers auto-fetch when URL changes
|
||||
document.addEventListener("DOMContentLoaded", () => {
|
||||
const urlInput = document.getElementById("UrlInput");
|
||||
const infoDiv = document.getElementById("videoInfo");
|
||||
|
||||
Reference in New Issue
Block a user