Rogner les espaces de chaque ligne

Une entrée vide ou uniquement composée d’espaces est rejetée avec une erreur invalid_input claire pour que l’automatisation ne traite jamais un collage blanc comme un nettoyage réussi. Le chemin est une logique de chaînes pure et déterministe—sans réseau, sans graines aléatoires, sans dépendance d’horloge—de sorte que l’exécuteur gratuit du navigateur et l’API prépayée renvoient le même JSON à chaque appel.

Ce que signifie le trim par ligne et pourquoi il diffère de String.trim

Une entrée entière vide ou uniquement d’espaces est une erreur dure : il n’y a pas de document nettoyé significatif à renvoyer, et les clients doivent le traiter comme invalid_input plutôt qu’un succès à zéro ligne.

Comment appeler l’API et ce que contient la réponse

Préférez envoyer le corps multiligne brut plutôt que de pré-effondrer les sauts de ligne lorsque vous voulez une vraie sémantique par ligne ; tout effondrer en une seule ligne ne rognerait que les bords extérieurs d’un unique segment. Envoyez un corps JSON avec un champ string obligatoire text (alias input, value, string, s, content et body). La valeur doit être une chaîne non vide après le trim global des espaces et ne doit pas dépasser cent mille caractères afin qu’une seule requête n’épuise pas la mémoire du Worker ou du navigateur sur d’énormes collages. En cas de succès la réponse renvoie input comme la chaîne d’origine envoyée, text comme le résultat entièrement rogné par ligne joint avec LF, line_count comme le nombre de lignes après découpage (y compris les vides), lines comme un tableau ordonné des chaînes de ligne rognées, chars_before et chars_after comme les longueurs des chaînes d’origine et nettoyée, chars_removed comme le nombre total de caractères retirés par le trim, et message comme un court résumé en anglais qui rapporte le nombre de lignes et les caractères retirés. Une validation échouée—text manquant, valeur non string, charge trop grande ou contenu vide après le trim global—renvoie invalid_input et n’est jamais facturée. Le tarif est un $0.002 forfaitaire par requête réussie avec unité item et prix unitaire marginal nul. À l’intégration, assertez sur text ou lines pour le contenu nettoyé, comparez éventuellement chars_removed pour des contrôles de régression, et traitez invalid_input comme un bug client sur les envois de formulaire vides plutôt qu’un événement de facturation.

Conseils pratiques, limites et recherches associées

Les contrôles aller-retour pour les tests sont simples : fournissez deux lignes remplies et attendez ces mots alignés à gauche sans espaces de fin ; fournissez une troisième ligne indentée par tab et confirmez que le tab a disparu tandis que les doubles espaces intérieurs d’une phrase restent ; envoyez délibérément une chaîne vide ou uniquement des espaces pour confirmer invalid_input et le message qui demande une chaîne non vide. Préférez data.clean_csv lorsque la charge est du CSV tabulaire avec corrections d’encodage ; préférez str.paragraph_count lorsque vous avez besoin de totaux de paragraphes par lignes vides ; préférez cette capacité lorsque des humains ont déjà séparé les lignes et que vous n’avez besoin que de bords propres sur chacune. Les tâches échouées qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui maintient bon marché la validation de formulaires et les tests négatifs de CI.