Chrome拡張APIの「chrome.downloads.onDeterminingFilename」に登録したリスナーの挙動がわからない

Question

onDeterminingFilenameのAPIリファレンスには以下のような記述があります。

Each extension may not register more than one listener for this event.

この記述を和訳すると「各拡張機能は、このイベントにたいして複数のリスナーを登録することができません」という意味になると思います。しかし、実際には、複数のリスナーを登録できます。

// 例１
const listener = (item, suggset) => {
	return suggset()
}

chrome.downloads.onDeterminingFilename.addListener(listener)
chrome.downloads.onDeterminingFilename.addListener(listener)

ただし、以下のケースではエラーが発生します。

// 例２
const listener1 = (item, suggset) => {
	return suggset()
}
const listener2 = (item, suggset) => {
	return suggset()
}

chrome.downloads.onDeterminingFilename.addListener(listener1)
chrome.downloads.onDeterminingFilename.addListener(listener2) // さっきと違う関数をリスナーとして登録する

上のコードでは、１度目に登録したリスナーと、２度目に登録したリスナーが違います。この場合、画像をダウンロードしたとき、以下のようなエラーが発生します。

suggestCallback may not be called more than once.

例１と例２は同様に２つのリスナーを登録しているわけですが、例２のコードはエラーが発生します。なぜこのような挙動になるのかしりたいです。

なぜこのような挙動になるのか知りたい理由

複数の画像をまとめてDLする拡張機能をつくっています。

その拡張機能の中で「同時にダウンロードしている画像の数だけonDeterminingFilenameにリスナーを登録する」というような処理があります。

その拡張機能のコードを抜粋したものがこちらです。長くてすみません。。。

import { extractExtensionFromFilename } from "../utils"
import TaskQueue from "./task-queue"

export default class DownloadTask {
	constructor({ urls, directory, concurrency }) {
		this.urls = urls
		this.directory = directory
		this.queue = new TaskQueue(concurrency)
	}

	start() {
		for (const url of this.urls) {
			this.queue.push(async () => {
				await this.download(url)
			})
		}
	}

	download(url) {
		return new Promise((resolve, reject) => {
			chrome.downloads.download({ url }, id => {
				const onChanged = item => {
					if (item.id !== id) {
						return
					}

					if (item.error) {
						// todo: handle error
						finish()
						return reject()
					}

					if (item.state?.current === 'complete') {
						finish()
						return resolve()
					}
				}

				const onDeterminingFilename = (item, suggest) => {
					if (item.id !== id) {
						return
					}

					const ext = extractExtensionFromFilename(item.filename)
					const index = this.urls.indexOf(url)
					const filename = ext
						? `${this.directory}/${index}.${ext}`
						: `${this.directory}/${index}`
					return suggest({ filename })
				}

				const finish = () => {
					chrome.downloads.onChanged.removeListener(onChanged)
					chrome.downloads.onDeterminingFilename.removeListener(onDeterminingFilename)
				}

				chrome.downloads.onChanged.addListener(onChanged)
				chrome.downloads.onDeterminingFilename.addListener(onDeterminingFilename)
			})
		})
	}
}

Answer 1

自己解決しました。同じ関数は１つしか登録できないようです。