kisimediaDE/cap-printer

Capacitor plugin for printing PDF documents - both local and remote.

npm install cap-printer
npx cap sync

• 📦 Installation
• 🔌 API
  • print(...)
  • isAvailable()
  • Interfaces
    • PrintRequest
    • PrintOptions
• 🧪 Usage
  • Basic usage
  • For local files
  • Plugin availability check (recommended for Web support)
• 📝 Changelog
• 🤝 Contributing
• 🪪 License

Plugin interface for CapPrinter.

print(options: PrintRequest) => Promise<void>

Print a PDF document from a remote URL or local file path.

Either url or localPath must be provided.

isAvailable() => Promise<{ available: boolean; }>

Returns whether the plugin is available on the current platform.

Returns: Promise<{ available: boolean; }>

Parameters for a print request.

Optional print configuration for native print dialogs.

import { CapPrinter } from 'cap-printer';

await CapPrinter.print({
  url: 'https://example.com/your.pdf',
  options: {
    outputType: 'photo',
    orientation: 'landscape',
    duplex: true,
  },
});

import { CapPrinter } from 'cap-printer';

await CapPrinter.print({
  localPath: '/path/to/your/file.pdf',
});

import { CapPrinter } from 'cap-printer';

const { available } = await CapPrinter.isAvailable();

if (!available) {
  console.warn('CapPrinter is not available on this platform.');
  return;
}

await CapPrinter.print({ url: 'https://example.com/your.pdf' });

ℹ️ On Web, isAvailable() always returns false.

For a detailed list of changes and version history, check out the CHANGELOG.md.

Contributions are welcome!
If you'd like to improve the plugin, report an issue, or suggest a feature, feel free to open a pull request or create an issue.

This plugin is licensed under the MIT License.