Some test text!

Search
Hamburger Icon

Core / Guides / Nodejs Memory Management

Memory Management in Node.js

The Apryse SDK in Node.js automatically cleans up all objects in memory when a process is initialized using PDFNet.runWithCleanup() once the process has finished running. In almost all cases, it is recommended to use the PDFNet.runWithCleanup() function to avoid memory leaks and complicated memory management.

For most situations, using PDFNet.runWithCleanup() and [Obj].takeOwnership() is sufficient for managing memory. However, there are additional ways to manage your memory usage:

Retain objects

In some situations you may wish to retain an object after the process has finished. A common example of this would be to create a document and retain it after processing. The ElementEdit sample on the samples page has an example of how this can be done.

  • [Obj].takeOwnership()

Deallocate objects

Deallocates individual objects. Only objects that derive from PDFNet.Destroyable have this method.

  • [Obj].destroy()

Deallocate stack

Stack-based deallocation. Calling endDeallocateStack() will deallocate all objects that were created since the last call to PDFNet.startDeallocateStack(). In general, stack-based deallocation is recommended because it is easier to manage for larger sections of code.

  • PDFNet.startDeallocateStack()
  • PDFNet.endDeallocateStack()

Some examples

Here are some examples for the various deallocation options

Automatic (default) deallocation

async function main() {
  try {
    // documents require deallocation
    const doc = await PDFNet.PDFDoc.create();
    // object that requires deallocation
    const page_iter = await doc.getPageIterator();
    // object that requires deallocation
    const writer = await PDFNet.ElementWriter.create();
  } catch (err){
    console.log(err);
  }
}

// deallocates all objects once main finishes running
PDFNet.runWithCleanup(main);

Individual deallocation

async function main() {
  try {
    const doc = await PDFNet.PDFDoc.create();
    const page_iter = await doc.getPageIterator();
    const writer = await PDFNet.ElementWriter.create();
  } catch (err){
    console.log(err);
  } finally {
    await doc.destroy();
    await page_iter.destroy();
    await writer.destroy();
  }
}
PDFNet.runWithoutCleanup(main);

Stack-based deallocation

async function main() {
  try {
    await PDFNet.startDeallocateStack();
    const doc = await PDFNet.PDFDoc.create();
    const page_iter = await doc.getPageIterator();
    const writer = await PDFNet.ElementWriter.create();
    await PDFNet.endDeallocateStack();
  } catch (err){
    console.log(err);
  }
}
PDFNet.runWithoutCleanup(main);

Trial setup questions? Ask experts on Discord
Need other help? Contact Support
Pricing or product questions? Contact Sales