Repository navigation
Releases: DeepL/deepl-node
Releases · DeepL/deepl-node
Release list
v1.28.1
v1.28.0
Added
- Added support for using multiple glossaries in text and document translation
via theglossaryIdsoption (up to 5 glossary IDs) inTranslateTextOptions
andDocumentTranslateOptions. - Added support for style rules in document translation via the
styleRule
option inDocumentTranslateOptions. - Added support for translation memories in document translation via the
translationMemoryandtranslationMemoryThresholdoptions in
DocumentTranslateOptions. - Added support for the translation memory management APIs:
getTranslationMemory(),listTranslationMemorySegments(),
deleteTranslationMemory(),createTranslationMemoryImport(),
uploadTranslationMemoryFile(),createTranslationMemoryExport(),
getTranslationMemoryJob(),isTranslationMemoryJobComplete(), and
downloadTranslationMemoryExport(), along with the
importTranslationMemoryFromFilepath()and
exportTranslationMemoryToFilepath()convenience functions that create the
job, transfer the TMX file, and wait for the job to finish. Because the API
detects the file upload asynchronously, an import job keeps reporting
awaiting_inputfor a while after the upload; the wait loop polls through
that status and accepts an optionaltimeoutMsto bound the wait. - Added the
TranslationMemorySegments,TranslationMemorySegment,
TranslationMemoryTargetSegment,TranslationMemorySegmentsOptions,
TranslationMemoryImport,TranslationMemoryExport,TranslationMemoryJob,
TranslationMemoryJobResult, andTranslationMemoryJobStatustypes. - Added optional
creationTimeandupdatedTimefields to
TranslationMemoryInfo.
Changed
- Requests to the pre-signed storage URLs used for translation memory import and export now
go through a separate HTTP client that is constructed without the DeepLAuthorization
header, instead of stripping it per request. Headers supplied viaTranslatorOptions.headers
are no longer sent to those URLs either — only theUser-Agentand the per-request
Content-Type. Proxy settings are unaffected.
Fixed
- The debug log helper no longer crashes when axios error fields return a non-primitive from
toStringorSymbol.toPrimitive.
Security
- Bumped
axiosto^1.19.0,form-datato^3.0.5, andadm-zipto
^0.6.0to resolve high-severity npm audit advisories in production
dependencies.
v1.26.0
Added
- Added support for translation memories in text translation via
translationMemoryandtranslationMemoryThresholdoptions in
translateText(). - Added
listTranslationMemories()method to theDeepLClientclass for
listing available translation memories.
Changed
- Bumped
axiosdependency due to CVE-2025-62718
Fixed
- Fix write tests that broke from language expansion
v1.25.0
Added
- Added new language constants from January 2026 API release of 81 new languages.
- Added
jsonBodyoption toSendRequestOptions, enabling JSON-encoded API calls. - Added support for style rules CRUD endpoints in the
DeepLClientclass:createStyleRule(),getStyleRule(),updateStyleRuleName(),updateStyleRuleConfiguredRules(), anddeleteStyleRule(). - Added support for style rule custom instruction CRUD endpoints in the
DeepLClientclass:createStyleRuleCustomInstruction(),getStyleRuleCustomInstruction(),updateStyleRuleCustomInstruction(), anddeleteStyleRuleCustomInstruction().
Please refer to the README for usage instructions.
v1.24.0
Added
- Added
tagHandlingVersionparameter totranslateText()to specify which version of the tag handling algorithm to use. Options arev1andv2.
v1.23.0
Added
- Added
customInstructionsparameter totranslateText()to customize translation behavior with up to 10 instructions (max 300 characters each). Only supported for target languages:de,en,es,fr,it,ja,ko,zhand their variants. Note: using thecustomInstructionsparameter will usequality_optimizedmodel type as the default. Requests combiningcustomInstructionsand thelatency_optimizedmodel type will be rejected.
v1.22.0
Added
- Added support for the
GET /v3/style_rulesendpoint in the client library, the implementation can be found in theDeepLClientclass. Please refer to the README for usage instructions - Added
styleIdoption totranslateText()which allows text and document translation with style rules.
v1.21.0
Added
- Added
extraRequestParametersoption to text and document translation methods to pass arbitrary parameters in the request body. This can be used to access beta features or override built-in parameters (such astarget_lang,source_lang, etc.).
v1.20.0
Added
- Official support for Node.js versions 20, 22 and 24
Fixed
- Fixed document minification/deminification to preserve translated content. Previously, when document minification was enabled, the deminify process would use the original minified file instead of the translated version, causing translations to be lost.
- Fixed handling of documents without media files during translation. The library now correctly processes documents that don't contain embedded media.
v1.19.0
Added
- Add new supported language codes to the translation and glossary language types.