51 lines
2.1 KiB
C#
51 lines
2.1 KiB
C#
using System;
|
|
|
|
namespace EmbedIO.WebSockets
|
|
{
|
|
/// <summary>
|
|
/// The exception that is thrown when a WebSocket gets a fatal error.
|
|
/// </summary>
|
|
#pragma warning disable CA1032 // Implement standard exception constructors - this class doesn't need public constructors.
|
|
public class WebSocketException : Exception
|
|
#pragma warning restore CA1032
|
|
{
|
|
internal WebSocketException(string? message = null)
|
|
: this(CloseStatusCode.Abnormal, message)
|
|
{
|
|
// Ignore
|
|
}
|
|
|
|
internal WebSocketException(CloseStatusCode code, Exception? innerException = null)
|
|
: this(code, null, innerException)
|
|
{
|
|
}
|
|
|
|
internal WebSocketException(CloseStatusCode code, string? message, Exception? innerException = null)
|
|
: base(message ?? GetMessage(code), innerException)
|
|
{
|
|
Code = code;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the status code indicating the cause of the exception.
|
|
/// </summary>
|
|
/// <value>
|
|
/// One of the <see cref="CloseStatusCode"/> enum values, represents the status code
|
|
/// indicating the cause of the exception.
|
|
/// </value>
|
|
public CloseStatusCode Code { get; }
|
|
|
|
internal static string GetMessage(CloseStatusCode code) => code switch {
|
|
CloseStatusCode.ProtocolError => "A WebSocket protocol error has occurred.",
|
|
CloseStatusCode.UnsupportedData => "Unsupported data has been received.",
|
|
CloseStatusCode.Abnormal => "An exception has occurred.",
|
|
CloseStatusCode.InvalidData => "Invalid data has been received.",
|
|
CloseStatusCode.PolicyViolation => "A policy violation has occurred.",
|
|
CloseStatusCode.TooBig => "A too big message has been received.",
|
|
CloseStatusCode.MandatoryExtension => "WebSocket client didn't receive expected extension(s).",
|
|
CloseStatusCode.ServerError => "WebSocket server got an internal error.",
|
|
CloseStatusCode.TlsHandshakeFailure => "An error has occurred during a TLS handshake.",
|
|
_ => string.Empty
|
|
};
|
|
}
|
|
} |