Method extractPages

src/api/pdf.ts:1816–1835

* Extract pages into a new PDF document. * * Creates a new document containing only the specified pages, copied from * this document. The original document is not modified. * * @param indices - Array of page indices to extract (0-based) * @param options - Extraction options * @r

(indices: number[], options: ExtractPagesOptions = {})

   * ```
   */
  async extractPages(indices: number[], options: ExtractPagesOptions = {}): Promise<PDF> {
    // Validate indices first
    for (const index of indices) {
      if (index < 0 || index >= this.getPageCount()) {
        throw new RangeError(`Page index ${index} out of bounds (0-${this.getPageCount() - 1})`);
      }
    }

    // Create new empty document
    const result = PDF.create();

    // Copy pages from this document to the new one
    if (indices.length > 0) {
      await result.copyPagesFrom(this, indices, {
        includeAnnotations: options.includeAnnotations ?? true,
      });
    }

    return result;
  }

  /**
   * Embed a page from another PDF as a reusable Form XObject.