Open Presentaties in JavaScript

Waar deze pagina over gaat

Leer hoe u PowerPoint- en OpenDocument‑presentaties opent in JavaScript, openingswachtwoorden opgeeft, het laden van resources beheert en het geheugenverbruik vermindert met Aspose.Slides voor Node.js via Java.

Inleiding

Aspose.Slides for Node.js via Java kan PowerPoint- en OpenDocument‑presentaties laden vanuit bestanden en streams. Nadat een presentatie is geladen, kunt u de structuur inspecteren, dia’s bewerken, resources beheren en deze opslaan in het oorspronkelijke of een ander ondersteund formaat.

Het laadgedrag kan worden aangepast via de LoadOptions‑klasse. U kunt bijvoorbeeld een openingswachtwoord opgeven, grote binaire objecten buiten het Node.js‑geheugen houden, externe resources beheersen of ingebedde binaire gegevens weglaten.

Presentaties openen

Na het laden van een bestand of stream kunt u het oorspronkelijke presentatieformaat bepalen om te kiezen hoe uw applicatie het verwerkt.

Om een bestaande presentatie te openen, geeft u het bestandspad door aan de Presentation‑constructor. Ruim de presentatie op nadat u deze hebt gebruikt, zodat bestands‑handles, tijdelijke gegevens en andere resources direct worden vrijgegeven.

Het volgende JavaScript‑voorbeeld laat zien hoe u een presentatie opent en het aantal dia’s opvraagt:

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("sample.pptx");
try {
    console.log("Slide count: " + presentation.getSlides().size());
} finally {
    presentation.dispose();
}

Wachtwoord‑beveiligde presentaties openen

Een openingswachtwoord versleutelt de inhoud van de presentatie. Om de volledige presentatie te laden, geeft u het juiste wachtwoord door aan LoadOptions.setPassword en levert u de opties aan de Presentation‑constructor. Het laden mislukt wanneer het wachtwoord ontbreekt of onjuist is.

const slides = require("aspose.slides.via.java");

const loadOptions = new slides.LoadOptions();
loadOptions.setPassword("open_password");

const presentation = new slides.Presentation("encrypted-presentation.pptx", loadOptions);
try {
    console.log("Slide count: " + presentation.getSlides().size());
} finally {
    presentation.dispose();
}

Voor wachtwoorddetectie, -validatie en versleutelingsworkflows, zie Password-Protect Presentations. Als een versleutelde presentatie opzettelijk met openbare documenteigenschappen is opgeslagen, kunnen die eigenschappen zonder wachtwoord worden gelezen; zie Manage Presentation Properties.

Grote presentaties openen

LoadOptions.getBlobManagementOptions retourneert opties die bepalen hoe Aspose.Slides binaire grote objecten (BLOB’s) zoals afbeeldingen, audio en video behandelt. U kunt het bronbestand vergrendeld houden, tijdelijke bestanden toestaan en de hoeveelheid BLOB‑gegevens die in het geheugen worden bewaard beperken.

De volgende JavaScript‑code demonstreert het laden van een grote presentatie (bijvoorbeeld 2 GB):

const slides = require("aspose.slides.via.java");

const filePath = "large-presentation.pptx";

const loadOptions = new slides.LoadOptions();
loadOptions.getBlobManagementOptions().setPresentationLockingBehavior(slides.PresentationLockingBehavior.KeepLocked);
loadOptions.getBlobManagementOptions().setTemporaryFilesAllowed(true);
loadOptions.getBlobManagementOptions().setMaxBlobsBytesInMemory(10 * 1024 * 1024);

const presentation = new slides.Presentation(filePath, loadOptions);
try {
    presentation.getSlides().get_Item(0).setName("Large presentation");
    presentation.save("large-presentation-copy.pptx", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Note

Met PresentationLockingBehavior.KeepLocked blijft het bronbestand vergrendeld tot de presentatie‑instance wordt vrijgegeven. Verplaats, overschrijf of verwijder het bronbestand niet zolang die instance actief is.

Aspose.Slides kan bij het laden de inhoud van een invoer‑stream kopiëren. Voor grote presentaties is een bestandspad daarom meestal efficiënter dan een stream. Zie Manage BLOBs voor extra opslag‑ en geheugemanagementopties.

Externe resources beheersen

LoadOptions.setResourceLoadingCallback accepteert een implementatie van IResourceLoadingCallback. De callback kan vervangende gegevens leveren, een resource omleiden, de standaardloader gebruiken of de resource overslaan. Dit is nuttig wanneer presentaties externe afbeeldingen bevatten die volgens toepassingsspecifieke beveiligings‑ of opslagregels moeten worden opgezocht.

const slides = require("aspose.slides.via.java");
const fs = require("fs");
const java = require("java");

const imageLoadingHandler = java.newProxy("com.aspose.slides.IResourceLoadingCallback", {
    resourceLoading: function(args) {
        const isJpeg = args.getOriginalUri().toLowerCase().endsWith(".jpg");
        const approvedImagePath = "approved-image.jpg";
        if (!isJpeg || !fs.existsSync(approvedImagePath)) {
            return slides.ResourceLoadingAction.Skip;
        }

        try {
            const imageData = fs.readFileSync(approvedImagePath);
            args.setData(imageData);
            return slides.ResourceLoadingAction.UserProvided;
        } catch (error) {
            console.error("The approved replacement image could not be read.");
            return slides.ResourceLoadingAction.Skip;
        }
    }
});

const loadOptions = new slides.LoadOptions();
loadOptions.setResourceLoadingCallback(imageLoadingHandler);

const presentation = new slides.Presentation("presentation-with-external-images.pptx", loadOptions);
try {
    console.log("Slide count: " + presentation.getSlides().size());
} finally {
    presentation.dispose();
}

Presentaties laden zonder ingebedde binaire objecten

Een presentatie kan ingebedde binaire data bevatten die een applicatie niet nodig heeft of niet wil behouden. Voorbeelden zijn:

• VBA‑projecten, beschikbaar via Presentation.getVbaProject;
• ingebedde OLE‑data, beschikbaar via OleEmbeddedDataInfo.getEmbeddedFileData;
• ActiveX‑controldata, beschikbaar via Control.getActiveXControlBinary.

Stel LoadOptions.setDeleteEmbeddedBinaryObjects in op true om deze binaire gegevens tijdens het laden te verwijderen. Sla de geladen presentatie op om het opgeschoonde resultaat te behouden.

Deze optie vermindert de blootstelling aan ongewenste ingebedde payloads, maar vormt geen volledig malware‑detectie‑ of content‑sanitisatiesysteem.

const slides = require("aspose.slides.via.java");

const loadOptions = new slides.LoadOptions();
loadOptions.setDeleteEmbeddedBinaryObjects(true);

const presentation = new slides.Presentation("presentation-with-embedded-data.pptx", loadOptions);
try {
    presentation.save("presentation-without-embedded-data.pptx", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

FAQ

Hoe kan ik zien dat een bestand corrupt is en niet geopend kan worden?

Aspose.Slides gooit tijdens het laden een parse‑ of format‑exception. Verwerk die fout apart van een onjuist‑wachtwoord‑fout, zodat de applicatie de oorzaak nauwkeurig kan rapporteren.

Wat gebeurt er als vereiste lettertypen ontbreken?

De presentatie kan nog steeds geladen worden, maar weergave en export kunnen lettertypen vervangen. U kunt fontvervanging configureren of aangepaste lettertypen leveren om de output voorspelbaarder te maken.

Laadt het laden van een presentatie ook de ingebedde media?

Ingebedde audio en video worden beschikbaar via het presentatiemodel. Externe resources worden opgezocht volgens het geconfigureerde resource‑laadgedrag en kunnen onbeschikbaar zijn als hun locaties niet toegankelijk zijn.