1
// Licensed to the Software Freedom Conservancy (SFC) under one
2
// or more contributor license agreements.  See the NOTICE file
3
// distributed with this work for additional information
4
// regarding copyright ownership.  The SFC licenses this file
5
// to you under the Apache License, Version 2.0 (the
6
// "License"); you may not use this file except in compliance
7
// with the License.  You may obtain a copy of the License at
8
//
9
//   http://www.apache.org/licenses/LICENSE-2.0
10
//
11
// Unless required by applicable law or agreed to in writing,
12
// software distributed under the License is distributed on an
13
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
// KIND, either express or implied.  See the License for the
15
// specific language governing permissions and limitations
16
// under the License.
17

18
/**
19
 * @fileoverview Atom to access application cache status.
20
 *
21
 */
22

23
goog.provide('bot.appcache');
24

25
goog.require('bot');
26
goog.require('bot.Error');
27
goog.require('bot.ErrorCode');
28
goog.require('bot.html5');
29

30

31
/**
32
 * Returns the current state of the application cache.
33
 *
34
 * @param {Window=} opt_window The window object whose cache is checked;
35
 *     defaults to the main window.
36
 * @return {number} The state.
37
 */
38
bot.appcache.getStatus = function(opt_window) {
39
  var win = opt_window || bot.getWindow();
40

41
  if (bot.html5.isSupported(bot.html5.API.APPCACHE, win)) {
42
    return win.applicationCache.status;
43
  } else {
44
    throw new bot.Error(bot.ErrorCode.UNKNOWN_ERROR,
45
        'Undefined application cache');
46
  }
47
};
48

49