Tronquer du texte

Une longueur inférieure à un est rejetée avec une erreur invalid_input claire, de sorte que la validation de formulaire et l'intégration continue ne traitent jamais un plafond nul ou négatif comme un succès. Le traitement repose sur une logique de chaînes pure et déterministe — aucun réseau, aucune graine aléatoire, aucune dépendance à l'horloge —, donc l'exécuteur gratuit du navigateur et l'API prépayée renvoient le même JSON à chaque appel.

Ce que signifie tronquer avec points de suspension, par rapport à réécrire ou rogner

Sinon, le moteur calcule un budget de contenu égal à la longueur moins celle des points de suspension, prend un préfixe jusqu'à ce budget, recule éventuellement jusqu'à l'espace précédent lorsque word_boundary vaut true, supprime les espaces finaux du préfixe conservé pour que les points de suspension ne suivent pas un vide parasite, puis concatène les points de suspension.

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

Envoyez un corps JSON avec le champ obligatoire text (alias input, value, string, s, content et body) et le champ obligatoire length (alias max_length, max, n, limit et max_len). La longueur doit être un entier compris entre un et cent mille inclus ; les valeurs inférieures à un, les non-entiers et les limites excessives déclenchent invalid_input. Le champ facultatif word_boundary (alias word, soft, on_word) vaut false par défaut et accepte les booléens true ou false. Le champ facultatif ellipsis (alias suffix, ending, marker) vaut par défaut trois points ASCII et peut être toute chaîne d'au plus trente-deux caractères ; lorsqu'une troncature est nécessaire, les points de suspension ne doivent pas dépasser length, sinon la requête échoue au lieu d'inventer un marqueur écourté. Le texte doit rester sous cent mille caractères afin qu'une seule requête ne puisse épuiser la mémoire du Worker ou du navigateur. En cas de succès, la réponse renvoie input comme chaîne d'origine, text comme chaîne finale à afficher, length comme maximum demandé, original_length et result_length comme nombres de caractères, truncated comme booléen, word_boundary comme indicateur envoyé (ou par défaut), ellipsis comme suffixe utilisé, used_word_boundary lorsqu'une coupure souple a été appliquée, et message comme bref résumé en anglais. Une validation en échec — text ou length manquant, text non chaîne, length non entier ou inférieur à un, charge utile excessive, ou points de suspension incompatibles avec la limite lorsqu'une coupure est requise — renvoie invalid_input et n'est jamais facturée. La tarification est forfaitaire : $0.002 par requête réussie, avec unité item et prix marginal nul.

Conseils pratiques, limites et recherches associées

Utilisez cette capacité lorsque l'intention de recherche est tronquer un texte, ajouter des points de suspension à une longueur maximale ou couper en douceur sur une limite de mot en ligne. Des points de suspension personnalisés, comme le caractère Unicode unique de points de suspension horizontaux ou un libellé « plus » entre crochets, fonctionnent tant que leur longueur reste dans le budget. Cette page n'est ni un résumeur IA, ni un compteur de paragraphes ou de mots, ni un convertisseur de casse de titre, ni un simple rogneur de bords de ligne. Les vérifications aller-retour pour les tests sont simples : fournissez une longue phrase avec une longueur de vingt et attendez-vous à truncated true et un result_length d'au plus vingt ; activez word_boundary sur une phrase de plusieurs mots et vérifiez que le dernier caractère conservé ne se trouve pas à l'intérieur d'un mot lorsqu'un espace existait plus tôt ; envoyez une longueur nulle ou un entier négatif et attendez-vous à invalid_input mentionnant une longueur inférieure à un. Préférez une coupure franche lorsque vous avez besoin d'une grille de caractères fixe, comme des journaux à chasse fixe ; préférez word_boundary pour les titres et aperçus destinés aux humains, où les coupures en plein mot paraissent défectueuses. Préférez text.shorten lorsqu'il vous faut une compression préservant le sens sous un budget de mots avec un modèle de langage ; préférez str.trim_lines lorsqu'il vous faut seulement nettoyer les espaces par ligne ; préférez cette capacité lorsque le produit a déjà décidé d'une longueur d'affichage maximale stricte et doit montrer un préfixe fidèle. Les tâches en échec qui renvoient invalid_input ne consomment pas de solde prépayé, ce qui maintient la validation de formulaires et les tests négatifs d'intégration continue à bas coût. Pour former des relecteurs, montrez la même phrase en modes strict et souple afin qu'ils voient que seules la position de coupure et l'indicateur used_word_boundary changent, tandis que la règle des points de suspension reste identique.