Class (GI Struct)

Soup-3.0SoupMessageMetricsAbstract

Contains metrics collected while loading a Message either from the network or the disk cache.

Metrics are not collected by default for a Message, you need to add the flag Soup.MessageFlags.COLLECT_METRICS to enable the feature.

Temporal metrics are expressed as a monotonic time and always start with a fetch start event and finish with response end. All other events are optional. An event can be 0 because it hasn't happened yet, because it's optional or because the load failed before the event reached.

Size metrics are expressed in bytes and are updated while the Message is being loaded. You can connect to different Message signals to get the final result of every value.

Index

Constructors

Properties

Methods

  • Get the time immediately after the Message completed the connection to the server. This includes the time for the proxy negotiation and TLS handshake.

    It will be 0 if no network connection was required to fetch the resource (a persistent connection was used or resource was loaded from the local disk cache).

    Returns number

    the connection end time

  • Get the time immediately before the Message started to establish the connection to the server.

    It will be 0 if no network connection was required to fetch the resource (a persistent connection was used or resource was loaded from the local disk cache).

    Returns number

    the connection start time

  • Get the time immediately after the Message completed the domain lookup name for the resource.

    It will be 0 if no domain lookup was required to fetch the resource (a persistent connection was used or resource was loaded from the local disk cache).

    Returns number

    the domain lookup end time

  • Get the time immediately before the Message started the domain lookup name for the resource.

    It will be 0 if no domain lookup was required to fetch the resource (a persistent connection was used or resource was loaded from the local disk cache).

    Returns number

    the domain lookup start time

  • Get the time immediately before the Message started to fetch a resource either from a remote server or local disk cache.

    Returns number

    the fetch start time

  • Get the number of bytes sent to the network for the request body.

    This is the size of the body sent, after encodings are applied, so it might be greater than the value returned by MessageMetrics.get_request_body_size. This value is available right before Soup.Message::wrote-body signal is emitted, but you might get an intermediate value if called before.

    Returns number

    the request body bytes sent

  • Get the request body size in bytes. This is the size of the original body given to the request before any encoding is applied.

    This value is available right before Soup.Message::wrote-body signal is emitted, but you might get an intermediate value if called before.

    Returns number

    the request body size

  • Get the number of bytes sent to the network for the request headers.

    This value is available right before Soup.Message::wrote-headers signal is emitted, but you might get an intermediate value if called before.

    Returns number

    the request headers bytes sent

  • Get the time immediately before the Message started the request of the resource from the server or the local disk cache.

    Returns number

    the request start time

  • Get the number of bytes received from the network for the response body.

    This value is available right before Soup.Message::got-body signal is emitted, but you might get an intermediate value if called before. For resources loaded from the disk cache this value is always 0.

    Returns number

    the response body bytes received

  • Get the response body size in bytes.

    This is the size of the body as given to the user after all encodings are applied, so it might be greater than the value returned by MessageMetrics.get_response_body_bytes_received. This value is available right before Soup.Message::got-body signal is emitted, but you might get an intermediate value if called before.

    Returns number

    the response body size

  • Get the time immediately after the Message received the last bytes of the response from the server or the local disk cache.

    In case of load failure, this returns the time immediately before the fetch is aborted.

    Returns number

    the response end time

  • Get the number of bytes received from the network for the response headers.

    This value is available right before Soup.Message::got-headers signal is emitted, but you might get an intermediate value if called before. For resources loaded from the disk cache this value is always 0.

    Returns number

    the response headers bytes received

  • Get the time immediately after the Message received the first bytes of the response from the server or the local disk cache.

    Returns number

    the response start time

  • Get the time immediately before the Message started the TLS handshake.

    It will be 0 if no TLS handshake was required to fetch the resource (connection was not secure, a persistent connection was used or resource was loaded from the local disk cache).

    Returns number

    the tls start time