JavaScript: The Definitive Guide, Fourth Edition

Name

Navigator.plugins.refresh( ) — make newly installed plugins available

Availability

Netscape 3

Synopsis

navigator.plugins.refresh([reload])

Arguments

reload

An optional boolean argument that, if true, specifies that refresh( ) should reload any pages that contain <embed> tags and use plugins. Defaults to false if omitted.

Description

The refresh( ) method causes Netscape to check whether any new plugins have been installed. If so, the plugins[] array is updated (“refreshed”) to include the newly installed plugins. If the reload argument is specified and is true, Netscape also reloads any currently displayed documents that contain <embed> tags and use plugins.

Note the unusual synopsis for this method. refresh( ) is a method of the plugins[] array, not of the Navigator object. For almost all purposes, however, it is simpler to consider it a method of the Navigator object, which is why it is grouped here with the methods and properties of that object.