nsICharsetResolver

Method overview

Methods

notifyResolvedCharset()

Some implementations may request that they be notified when the charset is actually detected.

void notifyResolvedCharset(
  in ACString charset,
  in nsISupports closure
);

Parameters

charset

The detected charset.

closure

The closure returned by requestCharset().

requestCharset()

Called to resolve the charset that should be used for parsing the document being loaded from aChannel.

If the charset cannot be resolved, but the implementation of nsICharsetResolver wants to be notified of the final resolved charset when one is available, it can set aWantCharset to true. If this is done, the caller of requestCharset is responsible for calling notifyResolvedCharset() and passing it the final resolved charset and the closure that requestCharset set.

ACString requestCharset(
  in nsIWebNavigation aWebNavigation,
  in nsIChannel aChannel,
  out boolean aWantCharset,
  out nsISupports aClosure
);

Parameters

aWebNavigation

The nsIWebNavigation the document is being loaded in. May be null.

aChannel

The channel the document is coming in from.

aWantCharset

Gets set to true if notifyResolvedCharset() should be called with the given aClosure object.

aClosure

A resulting object which should be passed to notifyResolvedCharset() if aWantCharset is set to true.

Return value

The resolved charset, or an empty string if no charset could be determined.