Merge Chromium + Blink git repositories
[chromium-blink-merge.git] / chrome / common / extensions / api / certificate_provider_internal.idl
blobaa179d269709379b93a2d09c8feb718ffc7a9baa
1 // Copyright 2015 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 // Internal API backing the chrome.certificateProvider API events.
6 // The internal API associates events with replies to these events using request
7 // IDs. A custom binding is used to hide these IDs from the public API.
8 // Before an event hits the extension, the request ID is removed and instead a
9 // callback is added to the event arguments. On the way back, when the extension
10 // runs the callback to report its results, the callback magically prepends the
11 // request ID to the results and calls the respective internal report function
12 // (reportSignature or reportCertificates).
13 [implemented_in = "chrome/browser/extensions/api/certificate_provider/certificate_provider_api.h"]
14 namespace certificateProviderInternal {
15 callback DoneCallback = void ();
16 callback ResultCallback = void (ArrayBuffer[] rejectedCertificates);
18 interface Functions {
19 // Matches certificateProvider.SignCallback. Must be called without the
20 // signature to report an error.
21 static void reportSignature(
22 long requestId,
23 optional ArrayBuffer signature,
24 optional DoneCallback callback);
26 // Matches certificateProvider.CertificatesCallback. Must be called without
27 // the certificates argument to report an error.
28 static void reportCertificates(
29 long requestId,
30 optional certificateProvider.CertificateInfo[] certificates,
31 optional ResultCallback callback);