contentDisposition function
Content-Disposition by RFC 6266: an ASCII filename for old clients and
filename* (RFC 5987) when the name is not plain ASCII. A name with a
path or a control character is a programming error, as in Symfony's
HeaderUtils::makeDisposition.
Implementation
String contentDisposition(String name, {bool inline = false}) {
if (name.isEmpty || name.contains(RegExp(r'[/\\\x00-\x1f\x7f]'))) {
throw ArgumentError.value(name, 'name', 'Not a file name.');
}
final kind = inline ? 'inline' : 'attachment';
final fallback = name
.replaceAll(RegExp(r'[^\x20-\x7e]'), '_')
.replaceAll('%', '_')
.replaceAllMapped(RegExp(r'["\\]'), (match) => '\\${match[0]}');
final plain = RegExp(r'^[\x20-\x7e]*$').hasMatch(name) && !name.contains('%');
if (plain) {
return '$kind; filename="$fallback"';
}
return "$kind; filename=\"$fallback\"; filename*=UTF-8''${_extValue(name)}";
}