Öppna presentationer i JavaScript

Vad den här sidan handlar om

Lär dig hur du öppnar PowerPoint- och OpenDocument-presentationer i JavaScript, anger öppningslösenord, kontrollerar resursladdning och minskar minnesanvändning med Aspose.Slides för Node.js via Java.

Introduktion

Aspose.Slides för Node.js via Java kan läsa PowerPoint- och OpenDocument-presentationer från filer och strömmar. När en presentation har lästs in kan du undersöka dess struktur, redigera bilder, hantera resurser och spara den i det ursprungliga eller ett annat stödd format.

Laddningsbeteendet kan anpassas via klassen LoadOptions . Till exempel kan du ange ett öppningslösenord, hålla stora binära objekt utanför Node.js-minnet, kontrollera externa resurser eller utelämna inbäddade binära data.

Öppna presentationer

Efter att ha läst in en fil eller ström kan du bestämma dess ursprungliga presentationsformat för att välja hur ditt program hanterar den.

För att öppna en befintlig presentation, skicka dess filsökväg till konstruktorn Presentation . Avsluta presentationen efter användning så att filhandtag, temporära data och andra resurser frigörs omedelbart.

Följande JavaScript‑exempel visar hur man öppnar en presentation och får antalet bilder:

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();
}

Öppna lösenordsskyddade presentationer

Ett öppningslösenord krypterar presentationsinnehållet. För att läsa in hela presentationen, skicka det korrekta lösenordet till LoadOptions.setPassword och ge alternativen till konstruktorn Presentation . Inläsningen misslyckas när lösenordet saknas eller är felaktigt.

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();
}

För lösenordsdetektering, validering och krypteringsarbetsflöden, se Lösenordsskyddade presentationer. Om en krypterad presentation medvetet sparats med offentliga dokumentegenskaper, kan dessa egenskaper läsas utan lösenord; se Hantera presentations‑egenskaper.

Öppna stora presentationer

LoadOptions.getBlobManagementOptions returnerar alternativ som styr hur Aspose.Slides hanterar stora binära objekt som bilder, ljud och video. Du kan hålla källfilen låst, tillåta temporära filer och begränsa mängden BLOB‑data som behålls i minnet.

Följande JavaScript‑kod demonstrerar hur man läser in en stor presentation (till exempel 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

Med PresentationLockingBehavior.KeepLocked förblir källfilen låst tills presentation‑instansen avlutas. Flytta, skriv inte över eller radera inte källfilen medan den instansen är levande.

Aspose.Slides kan kopiera innehållet i en inmatningsström under inläsning. För stora presentationer är en filsökväg därför vanligtvis mer effektiv än en ström. Se Manage BLOBs för ytterligare lagrings‑ och minneshanteringsalternativ.

Kontrollera externa resurser

LoadOptions.setResourceLoadingCallback accepterar en implementation av IResourceLoadingCallback . Återuppringningen kan tillhandahålla ersättningsdata, omdirigera en resurs, använda standardladdaren eller hoppa över resursen. Detta är användbart när presentationer innehåller externa bilder som måste lösas upp enligt applikationsspecifika säkerhets‑ eller lagringsregler.

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();
}

Läs in presentationer utan inbäddade binära objekt

En presentation kan innehålla inbäddad binär data som en applikation inte behöver eller inte vill behålla. Exempel inkluderar:

• VBA‑projekt, tillgängliga via Presentation.getVbaProject;
• inbäddad OLE‑data, tillgänglig via OleEmbeddedDataInfo.getEmbeddedFileData;
• ActiveX‑kontrolldata, tillgänglig via Control.getActiveXControlBinary.

Ställ in LoadOptions.setDeleteEmbeddedBinaryObjects till true för att ta bort denna binära data vid inläsning. Spara den inlästa presentationen för att bevara det sanerade resultatet.

Detta alternativ minskar exponeringen för oönskade inbäddade payloads, men det är inte ett fullständigt malware‑detekterings- eller innehållssaniteringssystem.

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();
}

Vanliga frågor

Hur kan jag avgöra att en fil är korrupt och inte kan öppnas?

Aspose.Slides kastar ett parse‑ eller format‑undantag under inläsning. Hantera det misslyckandet separat från ett fel lösenord‑fel så att applikationen kan rapportera orsaken exakt.

Vad händer om obligatoriska teckensnitt saknas?

Presentationen kan fortfarande laddas, men rendering och export kan ersätta teckensnitt. Du kan konfigurera teckensnittssubstitution eller tillhandahålla anpassade teckensnitt för att göra output mer förutsägbar.

Laddar inläsning av en presentation även dess inbäddade media?

Inbäddat audio och video blir tillgängligt via presentationsobjektmodellen. Externa resurser löses upp enligt den konfigurerade resursladdningsbeteendet och kan vara otillgängliga om deras platser inte kan nås.