How to Use IronPdfEngine

Mis à jour:juin 1, 2025

Translated

View the article in English

IronPdfEngine est un serveur gRPC conçu pour superviser une gamme de tâches IronPDF, englobant la création, la modification et la lecture de documents PDF.

class="hsg-featured-snippet">

Comment utiliser IronPdfEngine dans Node.js

Installez la bibliothèque Node.js pour utiliser IronPdfEngine.
Incluez la bibliothèque en l'installant via npm.
Obtenez le binaire Chrome via la même installation.
Vérifiez la version nécessaire en accédant à la propriété `ironPdfEngineVersion`.
Utilisez IronPdfEngine pour rendre HTML en PDF avec un rendu identique à Chrome.

Commencer avec IronPDF

IronPdf Node.js et IronPdfEngine

IronPdf pour Node.js requiert IronPdfEngine pour fonctionner. Le code Node.js n'est qu'un masque API sur le gRPC d'IronPdfEngine. Donc, lorsque vous appelez une méthode dans IronPdf pour Node.js, la magie opère à l'intérieur d'IronPdfEngine !

Par défaut, IronPdf pour Node.js lancera IronPdfEngine en tant que sous-processus et communiquera avec lui jusqu'à ce que votre application se ferme.

Remarque : Chaque version d'IronPdf pour Node.js requiert une version spécifique d'IronPdfEngine. Les versions croisées ne sont pas prises en charge.

IronPdf pour Node.js avec IronPdfEngine local

Option 1 : Télécharger IronPdfEngine lors de l'exécution

Par défaut, après avoir installé IronPdf dans votre projet JavaScript, lors de la première exécution, IronPdf détectera votre plateforme (par exemple, Windows x64) et téléchargera les binaires corrects d'IronPdfEngine depuis Internet.

npm install @ironsoftware/ironpdf

npm install @ironsoftware/ironpdf

SHELL

Avantages :

Votre package d'application sera petit.
Peut être déployé sur de nombreuses plateformes.

Inconvénients :

Un accès Internet est nécessaire lors des premières exécutions.
Temps de démarrage lent.

Option 2 (recommandée) : Installer IronPdfEngine comme une dépendance

IronPdf pour Node.js vous permet d'ajouter IronPdfEngine comme une dépendance. Ces dépendances IronPdfEngine regroupent IronPdfEngine dans un fichier .zip et l'extraient et l'utilisent automatiquement.

Vous pouvez choisir d'installer une ou plusieurs de ces dépendances IronPdfEngine.

Remarque : les versions de dépendance ironpdf et ironpdf-engine-xxx-xxx doivent être identiques. La version de la dépendance ironpdf-engine-xxx-xxx ne se réfère pas à la version d'IronPdfEngine à l'intérieur.

Installation spécifique à la plateforme :

Windows x64 :

npm install @ironsoftware/ironpdf-engine-windows-x64

npm install @ironsoftware/ironpdf-engine-windows-x64

SHELL

Windows x86 :

npm install @ironsoftware/ironpdf-engine-windows-x86

npm install @ironsoftware/ironpdf-engine-windows-x86

SHELL

Linux x64 :

npm install @ironsoftware/ironpdf-engine-linux-x64

npm install @ironsoftware/ironpdf-engine-linux-x64

SHELL

macOS x64 :

npm install @ironsoftware/ironpdf-engine-macos-x64

npm install @ironsoftware/ironpdf-engine-macos-x64

SHELL

macOS arm :

npm install @ironsoftware/ironpdf-engine-macos-arm64

npm install @ironsoftware/ironpdf-engine-macos-arm64

SHELL

Avantages :

Temps de démarrage plus rapide.
L'accès à Internet n'est pas nécessaire après l'installation de la dépendance.

Inconvénients :

Votre package d'application sera grand.
Besoin de spécifier les plateformes cibles.

IronPdf pour Node.js avec IronPdfEngine distant

Pour utiliser un IronPdfEngine distant, une version spécifique d'IronPdfEngine est nécessaire. Par exemple, si IronPdf pour Node.js version 2024.2.2 nécessite IronPdfEngine version 2024.2.2, n'utilisez pas la version 2024.2.1 d'IronPdfEngine. Accédez à la propriété ironPdfEngineVersion pour vérifier la version nécessaire.

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;

JAVASCRIPT

Comment se connecter

Supposons qu'IronPdfEngine fonctionne à distance à 123.456.7.8:33350.

Référez-vous à "Comment tirer et exécuter IronPdfEngine".

Pour vous connecter, vous devez simplement spécifier où IronPdfEngine est situé (assurez-vous que l'adresse est accessible, non bloquée par un pare-feu). Ajoutez ce code à l'étape initiale de votre application, ou juste avant d'appeler une méthode IronPdf.

IronPdfGlobalConfig.setConfig({
    ironPdfEngineDockerAddress: "123.456.7.8:33350"
});

IronPdfGlobalConfig.setConfig({
    ironPdfEngineDockerAddress: "123.456.7.8:33350"
});

JAVASCRIPT

C'est aussi simple que ça ! Après cela, votre application sera connectée à un IronPdfEngine distant !

Pour un IronPdfEngine distant, l'installation d'IronPdfEngine en tant que dépendance n'est pas nécessaire. Vous pouvez passer la section intitulée "Option 2 (recommandée) installer IronPdfEngine comme une dépendance."

Questions Fréquemment Posées

À quoi sert IronPdfEngine dans Node.js ?

IronPdfEngine est un serveur gRPC utilisé dans Node.js pour gérer les tâches PDF telles que la création, l'édition et le rendu, offrant une expérience de gestion PDF transparente.

Comment puis-je installer IronPDF pour Node.js ?

Vous pouvez installer IronPDF pour Node.js en utilisant npm avec la commande npm install @ironsoftware/ironpdf.

Quelles sont les différences entre les configurations locales et distantes pour IronPdfEngine ?

Une configuration locale implique soit le téléchargement d'IronPdfEngine à l'exécution, soit son installation en tant que dépendance, offrant des temps de démarrage plus rapides. Une configuration distante se connecte à un IronPdfEngine hébergé à distance, éliminant le besoin d'installations locales.

Comment garantir la compatibilité entre les versions d'IronPdf et d'IronPdfEngine ?

Chaque version d'IronPdf pour Node.js nécessite une version spécifique d'IronPdfEngine. Utilisez la propriété ironPdfEngineVersion pour vérifier la version requise et assurer la correspondance des versions.

Quels sont les avantages d'installer IronPdfEngine en tant que dépendance ?

Installer IronPdfEngine en tant que dépendance entraîne des temps de démarrage plus rapides et élimine le besoin d'accès à Internet après l'installation, bien que cela augmente la taille du package de l'application.

Comment puis-je me connecter à un IronPdfEngine distant ?

Pour vous connecter à un IronPdfEngine distant, utilisez IronPdfGlobalConfig.setConfig pour spécifier l'adresse du serveur, en vous assurant qu'elle est accessible et non bloquée par un pare-feu.

L'accès à Internet est-il requis pour les téléchargements à l'exécution d'IronPdfEngine ?

Oui, l'accès à Internet est requis lors des premières exécutions lors du téléchargement d'IronPdfEngine à l'exécution, ce qui entraîne également des temps de démarrage plus longs.

Ai-je besoin d'installer IronPdfEngine pour une utilisation à distance ?

Non, lorsque vous utilisez un IronPdfEngine distant, vous n'avez pas besoin de l'installer localement en tant que dépendance.

IronPdfEngine peut-il être utilisé sur différentes plateformes ?

Oui, IronPdfEngine peut être déployé sur plusieurs plateformes. Des commandes npm spécifiques aux plateformes sont disponibles pour les installations sur Windows, Linux et macOS.

IronPDF est-il compatible avec .NET 10 et quels environnements prend-il en charge ?

Oui, IronPDF est entièrement compatible avec .NET 10 (ainsi qu'avec .NET 9, 8, 7, etc.). Il prend en charge C#, VB.NET et F#, et fonctionne sur différentes plateformes telles que Windows, Linux et macOS (y compris les environnements Docker et cloud), ce qui le rend idéal pour les projets web, de bureau, console ou cloud utilisant .NET 10.

Curtis Chau

Discutez maintenant avec l'équipe d'ingénierie

Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Prêt à commencer?

Version : 2025.11 vient de sortir

Voir Licences