1 /*
2 * Copyright (c) 2002-2025 Gargoyle Software Inc.
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 * https://www.apache.org/licenses/LICENSE-2.0
8 *
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
14 */
15 package org.htmlunit;
16
17 import java.io.Serializable;
18
19 import org.htmlunit.html.HtmlPage;
20
21 /**
22 * A handler for JavaScript Window.print()
23 * (<a href="https://html.spec.whatwg.org/multipage/timers-and-user-prompts.html#printing">Printing Spec</a>).
24 * All js execution on page containing the document is blocked during the execution of the print method.
25 * <p>If the {@link PrintHandler} for the {@link WebClient} is null Window.print() will be a nopp including
26 * not triggering any print events.</p>
27 *
28 * @author Ronald Brill
29 */
30 public interface PrintHandler extends Serializable {
31
32 /**
33 * Handle a call to Window.print().
34 * @param page the {@link HtmlPage} to print
35 */
36 void handlePrint(HtmlPage page);
37 }