feat: add AbortController/AbortSignal support for request cancellation

[Copilot]

No way to cancel an in-flight translation request — once initiated, it runs to completion or timeout.

Changes

• Options interface — adds signal?: AbortSignal field
• translate() — forwards signal to the axios request config (axios ≥1.x supports AbortSignal natively)
• Tests — covers pre-aborted signal, mid-flight abort, and clean pass-through of a non-aborted signal

Usage

const controller = new AbortController();

const promise = googletrans("hello", { to: "zh", signal: controller.signal });

controller.abort(); // cancel at any time

await promise; // rejects with CanceledError

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• registry.npmmirror.com
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/_temp/ghcca-node/node/bin/npm install (dns block)
• translate.google.com
  • Triggering command: /opt/hostedtoolcache/node/24.14.0/x64/bin/node /opt/hostedtoolcache/node/24.14.0/x64/bin/node /home/REDACTED/work/googletrans/googletrans/node_modules/jest-worker/build/workers/processChild.js (dns block)
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node node_modules/jest/bin/jest.js --config jestconfig.json --testNamePattern=AbortController --runInBand (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[Feature request] add ability to abort/cancel/terminate the request mid-way</issue_title>
<issue_description>axios has supports for AbortController to terminate a request at any time.

googletrans doesn't have this in the options paramater and i would really appreciate it if you can add this as a new feature</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes [Feature request] add ability to abort/cancel/terminate the request mid-way #148

---

⚡ Quickly spin up Copilot coding agent tasks from anywhere on your macOS or Windows machine with Raycast.

[Copilot]

Pull request overview

Adds AbortController/AbortSignal-based cancellation support to in-flight translation requests by threading an optional abort signal through the public options and into the underlying axios request.

Changes:

• Extend Options with signal?: AbortSignal.
• Forward signal into the axios request config in translate().
• Add Jest coverage for pre-aborted, non-aborted, and aborted requests.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File	Description
src/googletrans.ts	Extends the translation options and passes the abort signal through to axios for request cancellation.
src/__tests__/test.ts	Adds new tests intended to verify AbortController/AbortSignal behavior.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[DarinRowe]

Closing in favor of #151, which now contains the reviewed AbortController support plus stronger deterministic test coverage.